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SECTION 66 

Sll Command Interpreter 

Sll Command Interpreter is designed for improved security and user 
convenience. It allows you to execute commands and run programs. Ac¬ 
cess to Sll Command Interpreter is controlled by the a'comint Q-field in 
the User Profile (see System/55 Index of Record Structures [S55-007], 
Section A-2 “Q-Field File;” see also System/55 Editorial Manager's Manu¬ 
al [S55-010], Section A-2, “User Definition”). 

The Command Interpreter does three things: 

1. Start processes 

2. Stop processes 

3. Check the status of processes 


Logging On 

_ To enter Sll Command Interpreter press IcmdI [Jj. A semicolon prompt 
is displayed. If you have not previously logged on (see “who” iater in this 
section) you are automatically logged on as null.null. 


To log on as a specific Tandem user from Sll Command Interpreter at 
the semicolon prompt, enter logon followed by the appropriate Tandem 
user name (for example, sn. super). If there is a hidden password enter a 
comma following the user name, press (ctrl) [p] and enter the password. 
Pressing [ctrl] [p] prevents the password from being displayed on the 
scr een. When you have entered the user name and password, press 
iRETURNtto complete the log-on process. 


;logon sii.super^ 

Figure 66.1. Logging On from Sll Command Interpreter 


Once you have logged-on, the system will remember your Tandem user 
name and its associated authorities until you log off or log on as a different 
Tandem user. 


Editing the Sll Command Interpreter Command Line 

You m ay edit an Sll Command Interpreter command line using the 

KSSilF 0keys at any tlme prior ,0 execu,in9 ,he command by 


Should you find that you have made an error in command line syntax 
after you have pressed (re t urn|, you may duplicate the command line 
edit it and then re-execute it. To do so, po sition the cursor on the command 
me you wish to change and press [move) . (T 0 duplicate the last command 
line entered you need only press the [move] key.) The entire command line 
will be moved to the position of the last semicolon prompt on your screen. 

ou may then make the necessary changes, and press [returnI to exe¬ 
cute the command. 
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Pressing the fCMol key while in Sll Command Interpreter interrupts the 
currently executing command. If a command or process is not executing 
when the [cmdI key is pressed, the semicolon prompt is displayed. 

Exiting Sll Command Interpreter 

To exit Sll Command Interpreter and return to your basket and desk list, 
at the semicolon prompt, enter IreturnI or IctrlI 0. 

In some cases, if you press Icmd| while you are running another Sll 
process, you will be reprompted by Sll Command Interpreter (the semico¬ 
lon prompt is displayed). 

If you now attempt to exit Sll Command Interpreter by pressing [return) 
or IctrlI 0 the message “Can’t return to text editing” is displayed, followed 
by the semicolon prompt. This indicates that a process is still attempting to 
access your terminal. 

To return to text editing, follow the steps below. The sequence is illus¬ 
trated in Figure 66.2. 

1. Type “pause” at the semicolon prompt. 

2. The prompt from the process you had previously executed is displayed. 

3. Exit that process by pressing IctrlI 0. 

4. The semicolon prompt is again displayed. 

5. Press IreturnI or Ictrl] 0 to exit and return to your basket and desk 
list. 



Figure 66.2. Exiting Sll Command Interpreter 


WHO 

The who command is useful if you forget your current Tandem user 
defaults. When executed, it displays your defaults as well as other informa¬ 
tion relating to Sll Command Interpreter. 

Enter who at the semicolon prompt to display the vdt name, vdt 
process name, pid of the Sll Command Interpreter, your Sll user name 
Tandem user name, (default security level), and your default volume and 
subvolume. The default system field of the who listing is displayed only 
if you have previously used the system command to supply a new param¬ 
eter. 

A typical who listing is illustrated in Figure 66.3. 



Figure 66.3. Listing Provided by the who Command 
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vdt name:—This number indicates which ftm (2) is controlling which side 
of this Coyote (l, the left side) through which port (8) of the ftm. 

vdt Process:—The ftm and its port form a unique name for the process, 
which can be used in other utilities to direct messages to this terminal, 
or stop and restart it. 

ci process:—Here the ci process is identified as \sn.oi , 01 9. This number 
has three fields: 

The system node field, the four characters between the back slash 
and the period. The node on which this terminal is running (Sll). 
The cpu number, the two digits between the period and the comma. 
This process is running in cpu 1 . 

The process number, the three digits after the comma. The number of 
this process is 1 9. 

Default volume: Ssystem.system gives the system an address when it 
is looking for a file. If you enter “fup purge joe” the system will use the 
default volume and default system to construct a complete run line: 

fup purge \SII. SSYSTEM.SYSTEM.JOE 

Sll user:—The sign-on name of the user. 

% 

Tandem user: which Tandem user you are logged on as. In command 
interpreter, you cease being an Sll user and become a Tandem user. 
Each Tandem user has a user name that is linked to an associated 
numeric value: 254.255 is sii.super, for example. 

If you use the network and the system command, you should use the 
who command frequently in order to avoid accidentally running programs 
in the wrong system, unintentionally purging remote files, and so on. 

The default system is in effect the next time you execute Sll Command 
Interpreter. If the default system is not the local system, it is displayed 
following the semicolon prompt when you execute Sll Command Interpret- 

ACTIVATE 

The activate command allows you to return a process from the 
suspended state to the ready state. A process can be suspended in one of 
two ways: by executing the suspend command; or, a process can sus¬ 
pend itself or another process (by executing the suspend process proce¬ 
dure). 

Standard Tandem users can only activate their own suspended pro¬ 
cesses. In other words, you can only activate a process, or a descendant 
of a process, that you ran. Specifically, your current user id must match the 
creation or process id of the process you are trying to activate, super.su¬ 
per can activate any process. 

When you execute the activate command, the designated process is 

placed in foe queue of processes ready for execution and is executed 
according to its priority. 
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To reactivate a particular process you must specify the process number 
or name. The syntax for the command is illustrated in Figure 66.4. 

;activate 01^083 


Figure 66.4. Activating a Process by Number 

If the process is not running on the system to which you are logged on, 
you must specify the system on which the process is running. The syntax 
for the command is illustrated in Figure 66.5, below. 


; ac t ivat e \s i i . $ epr g 


Figure 66.5. Activating Process Seprg on System \sn 


ALTPRI 

The altpri command allows you to change the execution priority of a 
process. Processes may be given priorities from 1 to 199. 

To change the priority of a particular process, you must specify the 
process number or name, and the new priority at which it is to run. If the 
process is not running on the system to which you are logged on, you must 
specify the network node on which the process is running. The syntax for 
this command is illustrated in Figure 66.6, below. 


; a 1tpr i $eqm j _,_132 ________ 

Figure 66.6. altpri Command to Change the Priority of Process Seqmj 

Standard Tandem users can alter the priority of only those processes 
and descendants of those processes they ran. This means that the current 
user’s user id must match the creation or process id of the process whose 
priority is to be altered, super.super can alter the priority of any process. 

Altering the priority of a process can have serious effects on your 
system’s performance. Be certain that you give careful consideration to the 
possible effects before you alter the priority of a process. 

CREATE 

The create command allows you to define a new unstructured disk file. 
When you create a file using this command, it will have the default security 
that was established when you logged on. The default security can be 
changed from Tandem Command Interpreter with the default command, 
but it will not become effective until the next time you log on. Once it has 
been assigned, you can change file security with the fup secure com¬ 
mand (see the Guardian Operating System Command Language and 
Utilities Manual). 

You may specify the maximum number of pages the file is to have by 
specifying extent size. (A file page is 2048 bytes; a file may have up to 16 
extents.) If no extent size is specified, one page is assumed. 
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For example, if your default volume and subvolume is Ssystem.editor 
and you wish to create a file named randy with those defaults, enter 
create randy at the semicolon prompt (illustrated in Figure 66.7). 


;create randy 

Figure 66.7. Command to Create File randy on Default Volume and Subvolume 

If you wish to create a file on another subvolume, you must specify the 
subvolume name for the file. For example, the command illustrated in 
Figure 66.8 creates Ssystem.class.sue with an extent size of seven 
pages. 


;createsystem,.class.sue, 7 

Figure 66.8. Command to Create File sue 

To create a file on another system on the network, the system name 
must be included in the create command as illustrated in Figure 66.9. 

5 c re ate \si i_. Ssystem. edi. tor. ti na 

Figure 66.9. Creating a File on Another Node of the Network 


FILES 

The files command allows you to display the file names associated with 
one or more subvolumes. 

Enter files at the semicolon prompt to display the names of all files on 
your default volume and subvolume. Figure 66.10 illustrates a typical list 
for a default volume and subvolume (in this case Ssystem.system). 


;files 

SSYSTEM.SYSTEM 

AOPE AOPRLOG AOPRLOGO APSDUMP ARMTRACE B 

UNLOAD UPDATE USERID USERIDAK VS VUP 

Figure 66.10. Command to List all Files on Default Volume and Subvolume 

To list all files on a particular volume and subvolume, enter the volume 
name followed by a period and the subvolume name. Figure 66.11 illus¬ 
trates the command syntax and a partial listing for all files in Ssystem.sys- 

DATA. 


; files ..Ssystem. .sysdata 
SSYSTEM.SYSDATA 


AOPRGROUP 

CHARS 

CHARFLGS 

CMON 

CHARS 

CMONO 

CHARSO 

CMON1 

CHARS1 

CONFIG 

CHARS2 

CONFIGO 

RESPONSE 

VCUCTRO 

STATDESC 

VSTOP 

SUBDEV 
VUPINFO 

DUBMIT 

VUPINFOO 

SUFFIX 

XYZZ 

SYSDESC 


Figure 66.11 . Command to List all Files in Volume Ssystem, Subvolume sysoata 


If you wish to list files in another system on the network, you must 
specify the system name. For example, files \sii.Ssystem.editor would 
display all files in volume Ssystem, subvolume editor on the \sn sys¬ 
tem. 


66.5 

















Sll Command Interpreter 


Utilities 


O (Obey) 

The o (obey) command allows you to instruct the Sll Command Inter¬ 
preter to execute a series of commands from a specified story or system 
file. The obey story or file may contain any Sll Command Interpreter 
commands except another obey command. 

Obey takes can be used to perform repetitious functions with a minimum 
of keyboarding. 

Creating an Obey File 

To create an obey file, enter the commands you wish the story or file to 
execute just as if you were executing them from Sll Command Interpreter. 

The NOTE Feature 

This feature allows you to display a message on the terminal from which 
the obey file or take is executed. Execution of the file is halted until the 
user presses Ireturni . 

To use this feature, simply enter note followed by the text of the 
message. 

« 

For example, an obey file that requires the user to be logged on as 
super.super might contain the following note as the first line of the obey 
file: 

NOTE ARE YOU LOGGED ON AS SUPER.SUPER? 

See Section 99, “System Obey Files,” Figure 99.19, for an example of 
an obey file that uses this feature. 

Executing an Obey File 

To obey a story or file you have created, enter “o (name)” at the 
semicolon prompt. 

You may stop execution of an obey take at any tima by pressing the IcmdI 
key. If you do so, the obey take stops executing and you are prompted for the 
next command. Depending on what was executing in the obey take, pressing 
IcmdI may leave you in a “Can't return to text editing” state. (See “Exiting Sll 
Command Interpreter,” and “pause.”) 

PAUSE 

Enter pause at the semicolon prompt. This causes the command inter¬ 
preter to stop prompting for commands. A command interpreter in the 
pause state is not awakened to prompt for a command until the most 
recently run process is deleted or you press the IcmdI key. 

When the pause command is executed, the command interpreter waits 
for “descendant stopped" messages about the process last run. If a pro¬ 
cess number is specified, command interpreter will pause until the speci¬ 
fied process stops. Note that the specified process gets “adopted” by the 
Sll Command Interpreter process and the 'stopped” message goes to the 
command interpreter, not to the process that created the specified pro¬ 
cess. 

PPD 

The ppd command allows you to display process names and informa¬ 
tion associated with all named processes currently entered in the pro¬ 
cess-pair directory. 
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To get a listing of all named processes in the process-pair directory, at 
the semicolon prompt, enter ppd and press IreturnI . Some of the entries 
that might be seen in a typical ppd listing are illustrated in Figure 66.12. 

To obtain a ppd listing of only named Editorial or only named Advertis¬ 
ing processes, enter ppd $e* or ppd Sc* to list all processes beginning 
with e or c respectively. 

To obtain a ppd listing for a single process enter ppd followed by the 
name of the process. 

Fields in the PPD Listing 

The entry in the name field is the name of the process. If the entry in this 
field is Szooo, this is the process started when the system is cold-started. 

The entry in the pidi field is the primary process number. The two digits 
preceding the comma indicate the cpu in which the process is running; the 
remaining digits identify the process. In Figure 66.12, the entry 02,058 
indicates that process 58 is running in cpu 2 . 


; PPD 
Name 
SZOOO 
SCMON 

PIDI 

00,023 
00,024 

PID2 

01,026 
01,027 

Parent 

00,000 
szooo • 

Program 

SSYSTEM 

SSYSTEM 

file name 
.SYS02 

.SYSTEM 

.COMINT 
. CMON 

SEGOD 

SCGOD 

01,040 
01,042 

00,054 
00,043 

SZEUS 

SZEUS 

SSYSTEM 

SSYSTEM 

. SII 

. SII 

GOD 

GOD 

SF812 

SF811 

00,070 
02,058 


SZEUS 

SZEUS 

SSYSTEM 

SSYSTEM 

.SYSTEM 
.SYSTEM 

ECONTROL 

ECONTROL 


Figure 66.12. Typical Entries in a ppd Listing 


The entry in the pid2 field is the backup process number. If there is no 
entry in this column, the process has no backup, and is therefore not 
NonStop. 

The entry in the parent field is the name or number of the process 
responsible for initially creating this process. 

When a ppd list shows a node name (\SII for example) it indicates that 
the process was started remotely: 

00,021 065 \SII. SF4. #R11 SSYSTEM .SII . Cl 

This ci process was started from system Sll from ftm 4 through port 11 
on the right side of the terminal. 

The entry in the program file name field is the name of the program 
file executed to create the process. 

PURGE 

The purge command is used to delete a disk file. When a file is purged, 
its disk file name is deleted from the volume’s directory and any space 
previously allocated to that file is made available to other files. Use cau¬ 
tion. The purge command executes immediately. 
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A file can be purged only if it is not currently in use (that is, it is not open) 
and the current user has purge access to the file or is logged on as 
super.super. Atypical purge command is illustrated in Figure 66.13. 

; pyrge..$s^stem..sii, stan __ 

Figure 66.13. Command to Purge File system.sii.stan 

Sets of files can be purged in a single operation with the fup purge 
command (see Guardian Operating System Command Languages and 
Utilities Manual). 

RELOAD 

The reload command is used to load a processor module’s operating 
system image during an initial cold load from disk or after a failed module 
has been made operable. The reload takes place while the remainder of 
the system operates in a normal manner. 

RENAME 

The rename command allows you to assign a new file name to an 
existing disk fiie. With the rename command you can change the subvol¬ 
ume name and or the disk file name but not the volume name. The volume 
name can only be changed by copying the file to another volume with the 
fup program (see the Tandem tns i or tns ii Master Index). 

To rename a file, at the semicolon prompt, enter rename followed by 
the current name of the file, a comma and the new name. Figure 66.14 
illustrates typical rename command syntax. 


; rename scan,.qspan _________ 

Figure 66.14. Typical rename Command Syntax 

In Figure 66.14, the rename command is used to rename the file 
containing the current version of the scan program (to oscan) so that a 
new version of the program can be installed while saving the old version. 

RUN/RUND 

The run command is used to run programs. The command also allows 
you to optionally specify the program’s input and output files, processor 
module, execution priority, number of data pages, and process name. The 
file must exist on the system that will run the program. 

Enter run at the semicolon prompt followed by the program name to 
start the process. Enter rund at the semicolon prompt followed by the 
program name to start the process and put it into debug state before it 
executes its first instruction. 

A series of options, as explained below, may be entered following the 
program name. Options must be enclosed in slashes and separated by 
commas as illustrated in Figure 66.15. The options may be specified in any 
order. 


; run Ssystem. system.request /IN Sdata.obey.test.OUT Ss. #s.Ip.TERM 
$osp, CPU O.PRI 135, MEM 8. NOWAIT, TERM Sa302/ __ 

Figure 66.15. RUN Command Syntax 
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RUN/RUND Options 

in allows you to specify the process’s input file, for example, “in $da- 
ta.obey.test”. If no file name is supplied, the out file of the com¬ 
mand interpreter (generally the terminal from which the run 
command is executed) is assumed. 

out allows you to specify the process’s output file, for example, “out 
$s.#s.lp”. If no file name is supplied, the out file of the command 
interpreter (generally the terminal from which the run command is 
executed) is assumed. 

name allows you to assign a name to the process. For example, name 
$rand. giving the process a name allows you to find it in the ppd 
listing. If you omit this parameter, the process is given only a number. 

cpu allows you to specify the processor in which the process is to run. If 
you do not specify a cpu number, the system will run the program in 
the processor in which the command interpreter is running. 

pri allows you to specify the priority at which the process is to run. A 
priority from 1 to 174 may be specified. If you do not specify a priority, 
the system will select a suitable priority. If you specify a priority 
greater than the maximum, an error message is given. 

mem allows you to specify the maximum number of virtual data pages 
(from 1 to 64) that are to be allocated to the process in cpu memory. 

nowait allows you to specify that the Sll Command Interpreter prompt is to 
be returned once the process has started. 

If you do not specify the nowait option when the run command is 
given, the command interpreter waits for the new process to stop 
before prompting again. Press fcMD] to redisplay the semicolon 
prompt. The command interpreter will then continue to run while the 
other process is running. However, if the other process needs to use 
the home terminal it will be blocked. To return the command interpret¬ 
er to its waiting state use the pause command. 

If you do specify the nowait option, the command interpreter redis¬ 
plays the semicolon prompt as soon as the new process is started 
and has read its parameter message. The nowait option is typically 
used when starting up several programs with an obey file. 

term allows you to specify the home terminal for the process (this is 
where the debug prompt is displayed if the process should go into 
debug). If the term option is not used, the home terminal of the 
command interpreter (generally, the terminal from which the run 
command is executed) is assumed. 

STATUS 

If you enter the status command with no parameters, it displays the 

status of all processes that have the executing terminal as the home 

terminal. 

To display the status of all processes running in all opus, enter an 

asterisk following the status command. Portions of a typical status * 

listing are illustrated in Figure 66.16. 
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;status * 


PID 

Pri 

Name 

Home Term 

Program 

file name 


00,000 

201 


$OSP 

SSYSTEM 

.SYS02 

OSIMAGE 

00,001 

210 


sosp 

SSYSTEM 

.SYS02 

,OSIMAGE 

00,023 

199 

$Z000 

sosp 

SSYSTEM 

.SYS02 

,COMINT 

00,054 

164 

SEGOD 

STERM4 

SSYSTEM 

. SII 

, GOD 

00,082 

140 

SA310 

STERM4 

SSYSTEM 

. SII 

,ECONTROL 

00,083 

140 

SA307 

STERM4 

SSYSTEM 

. SII 

.ECONTROL 

01,157 

140 


SF8. #R03 

SSYSTEM 

. SII 

. Cl 


Figure 66.16. status* Listing 

To display the status of a specific process, enter the process name or 
number following the status command. For example, status Segod. 

To display the status of all processes running in a particular cpu, enter 
the cpu number following the status command. For example, status i or 
status o. 

pid —The process identification number. In the last line of Figure 66.19, 

* process 157 is running in cpu 1. 

PR i__The priority at which the process runs. For the command interpreter 
in the last line of Figure 66.16, it is 140; the highest number allowed 
for Sll processes is 199; for Tandem processes, it is 225. A high 
priority does not mean faster response time; it is simply an expression 
of the process hierarchy. 

NAME _The process name. Note that there is never a process name for a 
command interpreter. 

program file name —The name of the program as it is stored on disk 
waiting to be run—at that instant becoming a process. The command 
interpreter process w^s swapped into cpu memory when the user 
pressed IcmdI H. 

home TERM— The location to which the debug process will send its 
prompt if the process goes into debug. 

The TERM Option 

The term option allows you to display the status of processes that, if 
they go into DEBUG, will display their prompt on the specified terminal. If 
you do not specify a terminal name, the executing terminal is assumed (the 
result is the same as if you had entered status with no parameters). 

Most processes use the logical device Sosp as their home terminal. To 
list those processes, enter: 

;status *, term Sosp 

The asterisk indicates that you want to know which processes in all 
cpus will send their debug prompts to the osp. 

Figure 66.17 illustrates a status listing for a Coyote terminal. 

; s t a t u s _ _ *. _ t e r m $ f 1 . #111 

PID Pri Name Home Term Program file name 

02,136 140 $F1. #L11 SSYSTEM .SII -Cl 

Figure 66.1 7. status Listing for Coyote Terminal 
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The PROG Option 

The prog option allows you to display the status of processes having a 
particular program file. To use it, enter prog followed by the program file 
name. For example, status*,prog sii.econtrol. 


The status command can be used to obtain a list of processes created 
from a single program. For example, $system.sii.econtrol, used to cre¬ 
ate all terminal processes. 


;status 
PID 

Pri 

prog 

Name 

Ssystem.sii.econtrol 
Home Term 

Program 

file 

name 

01,044 

140 

SF308 

SOSP 

SSYSTEM 

. SII 

.ECONTROL * 

01,046 

140 

SF306 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

01,047 

140 

SF307 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

01,048 

140 

$F212 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

01,049 

140 

SF213 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 


Figure 66.18 . status listing for Ssystem.sii.econtrol 


A status list may be obtained not only for a specific program but for a 
single cpu as well. The status command in Figure 66.19 lists all 
econtrol processes running in cpu 2. 


;status 


prog 

Ssystem.sii.econtrol 




PID 

Pri 

Name 

Home Term 

Program 

file 

name 

02,041 

140 

$F114 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

02,042 

140 

SF312 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

02,043 

140 

SF310 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 

02,044 

140 

C/3 

CO 

o 

o 

SOSP 

SSYSTEM 

. SII 

.ECONTROL 


Figure 66.19. status Listing of econtrol Processes in cpu 2 


If you specify both the prog and term options, only the status of 
processes satisfying both conditions is displayed. 

STATUS may also be used to check the status of any particular process 
(Figure 66.20). 


;status SZOOO 



PID Pri Name 

% 

Home Term 

Program file name 

00,013 198 SZOOO 

SOSP 

SSYSTEM .SYS14 .COMINT 

01,018 198 SZOOO 

SOSP 

SSYSTEM .SYS14 .COMINT 

2 Items listed 




Figure 66.20. status Listing for Process Szooo 


Notice that process Szooo has two pid numbers since it is running in 
NonStop mode with one process in cpu o and a second, backup process 
in cpu i. To determine the primary process, use the ppd command (for 
example, ppd Szooo). 

STOP 

The stop command allows you to stop a process that is currently 
running. At the semicolon prompt, enter stop followed by the name or 
number of the process you wish to stop. If the process is running on 
another system, you must enter the system name preceding the process 
name or number. The syntax of a typical stop command is illustrated in 
Figure 66.21. 
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; stop.$f207 _ 

Figure 66.21. Command to Stop Process $F207 


Standard Tandem users are allowed to stop only those processes and 
descendants of those processes that they ran. Your user id must match 
the creation id or the process id of the process you are trying to stop. 
super.super can stop any user process. 


Who Can Stop a Process? 

1. The creator (the command interpreter, either local or remote, that actu¬ 
ally initiated the process), or 


2. the same local creation ID, or 

3. the same local process ID, or 

4. the local super.super, or 

5. the local group.super, (of the creation id or process id). 

For example: a process with process id 000,000 and creation id of 

254.254 could be stopped by any user logged on as 000,000, 254,254, 

254.255 (group.super), or 000,255 (null group supervisor). Tandem users 
000,100 or 255,254 could not stop it. Note that the higher level Tandem id 
numbers do not allow greater authority over the lower id numbers (with the 


exception of the group.super). 

To determine whether you can stop a process, execute pstat (see 
Section 81) on the process and use the who command. Compare your 
Tandem id with those of the process you wish to stop. 

When a process that had been started manually is stopped, it stays 
stopped. When a process run from an obey file (for example, Scmon) is 
stopped, it stays stopped—even if it is a NonStop process. In each case, in 
order to restart the process a command must be entered manually, either 
as a run line or by executing its obey file. 

Any process that was started by $zeus, $egod, or Scgod will be restart¬ 
ed by its ancestor when it stops (or is stopped). The overseer is notified 
when one of its descendants has been stopped and reads through the 
configuration file to restart it. If the process is stopped a second time within 
one minute, it will not be restarted by the overseer. 


When you change the system field in the sign-on prompt, the appropri¬ 
ate control (econtrol or ccontrol) is stopped. Therefore, if you switch 
from system to system within one minute, the terminal will not come back. 
The process is stopped until a request is made to restart it (see Section 

85). 


SUSPEND 

The suspend command allows you lo prevent a process ircm compet 
inq for system resources. A suspended process cannot execute mstruc- 
tions until it is reactivated. A suspended process can be reactivated with 
the activate command. 

This command differs from stop since the process can resume execu¬ 
tion as though no interruption had occurred. 

At the semicolon prompt, enter suspend followed by the name or num¬ 
ber of the process you wish to suspend. The syntax of a typical suspend 
command is illustrated in Figure 66.22. 
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;suspend $rand 

Figure 66.22. Command to Suspend Process Srand 

The suspension does not take effect until the designated process be¬ 
comes ready to execute instructions. Therefore, any outstanding waits (as 
for i/o completion) are satisfied before the process is suspended. 

Standard Tandem users are allowed to suspend only those processes 
and descendants of those processes that they ran. That means that your 
user id must match the creator access id of the process you are trying to 
suspend, super.super can suspend any user process. 

SYSTEM 

To set the default system, at the semicolon prompt, enter system 
followed by the system name. If you enter the system command by itself, 
the local system is specified as the default. The local system is the system 
on which your command interpreter is running, not necessarily the system 
to which your terminal is physically connected. 


; sys t em \si i 

Figure 66.23. Command to Set Default System to \su 


TIME 

The time command allows you to display the current setting of the 
system's date and time-of-day clock. At the semicolon prompt, enter time 
as illustrated in Figure 66.24. 


; time 


Figure 66.24. time Command 

The time command applies only to the local system; you cannot obtain 
the time from a remote system unless you run a command interpreter on 
that system. 

Time is normally set at system coldstart with the Tandem utility settime. 

VOLUME 

The volume command is used to change the current user’s default 
volume and/or subvolume names. 

At the semicolon prompt, enter volume followed by the new volume 
and/or subvolume name(s) to change the current default setting. 

To change your default subvolume name, enter volume followed by the 
subvolume name. 

To change your default volume name, enter volume followed by the 
new volume name. 

To change both your default volume name and default subvolume name 
enter volume followed by the new volume and subvolume names. The 
command syntax for changing default volume and subvolume is illustrated 
in Figure 66.25. 
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; vo1ume $ svstem . s y s data 

Figure 66.25. Typical volume Command Syntax 

To display your current default volume without changing it, enter vol¬ 
ume without parameters. 

The default volume will return to the default for the Tandem user when 
you sign off. The volume command is effective only for the time you are 
signed on to your terminal. 
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SECTION 67 

DISKINFO 

This is an unsupported Tandem product. It is not maintained by Sll. 

DISKINFO is a process that provides disk space information for a speci¬ 
fied volume and subvolume or all subvolumes of a specified volume. 

The figures in this section show the information displayed by diskinfo 
as it appears on a Coyote vdt. When displayed on an et/960 some lines of 
the display may wrap. 


Running DISKINFO 

To list the disk space information for your default subvolume, enter 
diskinfo at the semicolon prompt, followed by IreturnI . 


;diskinfo 
SUBVOLUME 

PAGES 

BYTES* FILES 

82 OCT 07, 16:26:59 

• 

$SYSTEM.SYSTEM 

3341 

6842368 179 



TOTAL PAGES 
TOTAL BYTES 
TOTAL FILES 

3341 

6842368 

179 






Figure 67.1. diskinfo Listing for Default Subvolume 


To list disk space information for a 
enter the volume and subvolume name 

specific volume and subvolume, 
as in Figure 67.2. 


;diskinfo Sdata. 

editor 


% 


SUBVOLUME 

PAGES 

BYTES FILES 

82 OCT 07, 17:32:21 


SDATA.EDITOR 

15000 

30720000 5 



TOTAL PAGES 
TOTAL BYTES 
TOTAL FILES 

15000 

30720000 

5 





Figure 67.2. diskinfo Listing for Sdata.editor 
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To list disk space information for all subvolumes on a particular volume, 
enter the volume name followed by an asterisk, which acts as a wild card 
(Figure 67.3). 


; di sk i nf q_ $sy s t em. * 


SUBVOLUME 

PAGES 

BYTES 

FILES 

SSYSTEM.CCONTROL 

990 

2027520 

34 

SSYSTEM.CDUMP 

105 

215040 

8 

SSYSTEM.DICT 

1 

2048 

1 

SSYSTEM.ECONTROL 

1092 

2236416 

35 

SSYSTEM.FGEN 

436 

892928 

14 

SSYSTEM.FMOD 

70 

143360 

7 


SSYSTEM.SPEDIT 

118 

241664 

4 

SSYSTEM.STYL 

187 

382976 

17 

SSYSTEM.VPUTGET 

287 

587776 

10 

TOTAL PAGES 

46491 



TOTAL BYTES 

95213568 



TOTAL FILES 

1840 




82 OCT 07, 17:43:17 


Figure 67.3. Listing of all Subvolumes on Volume Ssystem 


At the end of the listing of all subvolumes on a specified volume, the 
total pages, bytes, and files is give n. You may interrupt the listing of 
subvolumes at any time by pressing IcmdI . The total pages, bytes, and 
files for the subvolumes listed up to that point is displayed. 
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SECTION 68 

DSTAT 

Standard Disk File Name: SSYSTEM.SYSTEM.DSTAT 
Process Revision Level : S0169.E01.000 (007) 

Description 

DSTAT is a utility for reporting vdt statistics that have been “collected” 
by the vstat program (See vstat, Section 41). dstat displays a report of 
response times, number of requests and average characters per second 
processed by a given command. It also displays a distribution of the 
justification and head fit requests separately in a second report. The 
meaning of all VDT commands reported by dstat can be found in the file 
Ssystem.sysdata.statdesc with list commands. See Section 19 for a 
description of gstat, a more comprehensive vdt statistics collection pro¬ 
cess. 


Execution Syntax 

To run dstat, start Sll Command Interpreter and enter dstat in re¬ 
sponse to the semicolon prompt. 


;dstat 


Figure 68.1 . Starting Process dstat 


DSTAT HELP Command 

DSTAT has a help command. To use it, run dstat and enter help at the 
process prompt. 


FC 

Interactively edit last command 

HELP [command] 

Print long command descriptions 

EXIT (or EOF!) 

Terminate execution of program 

DUMP 

Dump VDT statistics to the out file 

CLEAR 

Clear a VSTAT 1 s statistics tables 

INTERVAL [width] 

Change a VSTAT’s bin width 

CHARS [chars] 

change a VSTAT's just category width 

STAT [collector] 

Open the VSTAT named 

OUT 

Change the output location 


Figure 68.2. dstat help Command 


Available Commands 

The dump command causes the information in the statistics tables main¬ 
tained by vstat to be dumped to the out file. Since this information is 
formatted in such a way that each record exceeds 96 characters in 
length, dumping to a terminal produces output that is somewhat 
difficult to read. The statistics dumped are those that have accumulat¬ 
ed since vstat’s tables were last cleared. 
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Tine clear command causes the vstat’s statistics tables to be cleared 
and resets the collector’s clock. If statistics for a given period are 
desired, the tables should be cleared at the beginning of that period. 

The interval command is used to change the bin width used by the vstat 
process from the default of one second. The interval command also 
implicitly clears the statistics tables and resets the collector’s clock. 

The chars command is used to change the just category width used by 
the vstat process from the default of one thousand characters. It 
should be noted that the chars command implicitly clears the statis¬ 
tics tables and resets the collector’s clock. 

The stat command is used to name the stats collector (vstat) the user 
wishes to talk to. Until a valid collector has been named the dump, 
clear and interval commands will do nothing but generate error 
messages. 

The out command is used to change location to which the statistics are 
dumped. If no output location is specified it defaults to the in file 
(usually the terminal). If the output location is the spooler, only one job 
will be created regardless of how many times statistics are dumped, 
until the spooler is closed. 

Examples 

Dump Statistics Collected by Process SESTA 


♦stat SESTA 
♦dump 


Times 

Mean 


—— Response Time Distribution ( 

1.0 second intervals) 

Exec. 

Time 

< 

1.0< 2. 0< 3. 0< 4. 0< 5. 0< 6. 0< 7. 

,0< 8. 0< 9. 0> = 9.0 

A 

6 

.20 

6 


+ B 

1 

.15 

1 


+ D 

2 

.44 

2 


E 

2 

.31 

2 


G 

1 

.36 

1 


+ 0 

1 

. 19 

1 


*B 

5 

.43 

5 


*F 

1 

.17 

1 


*S 

2 

8.12 


2 

*T 

4 

.29 

4 



Figure 68.3. Statistics Collected by Process Sesta (partial) 


Mean 

Size 
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Clear Statistics of Collector SSTAT 
for Beginning of New Measurement 


*stat SSTAT 
*clear 

Figure 68.4. Commands to Clear Statistics of Collector Sstat for Beginning of New Measurement 


Change Bin Width to .5 Second Intervals 


*stat Sstat 







*interval .5 







New Time Interval 

.5 second 




*dump 







Times 

Mean - ■ 


Response Time Distribution ( 0.5 second intervals) 








Chars Mean 

Cmd. Exec. 

Time <0 

.5 <1 

. 0 <1 

. 5 <2. 0 <2. 5 <3. 0 <3. 5 <4. 0 <4. 5 > = 4. 5 

/Sec Size 

) 

2 

2. 24 



2 


+ 1 

1 

1. 15 



1 


4-2 

2 

. 42 

2 




+ 3 

2 

. 32 

2 




+ 4 

3 

. 39 

3 




4- 5 

1 

. 45 

1 




+ 6 

1 

. 34 

1 




4-7 

1 

. 43 

1 




A 

25 

. 35 

21 

2 

2 


B 

13 

. 17 

13 




+ B 

20 

. 14 

20 




C 

4 

.31 

4 




D 

1 

. 65 


1 



+ D 

18 

. 42 

14 

4 



E 

25 

. 32 

25 




F 

2 

. 37 

2 




G 

27 

. 24 

26 

1 



I 

4 

. 30 

4 




J 

28 

1. 63 



11 13 3 1 

422.9 693 

M 

22 

1. 25 

12 

5 

11 12 


N 

33 

. 26 

38 




0 

13 

. 39 

12 

1 



+ 0 

1 

1. 26 



1 


+ R 

20 

. 50 

9 

10 

1 


V 

7 

. 45 

3 

4 



+ v 

13 

. 39 

11 

1 

1 


X 

7 

. 77 


5 

2 


z 

11 

. 64 

3 

7 

1 



Figure 68.5. Change Bin Width to .5 Second Intervals (partial) 
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! D 

3 

2. 43 




1 

1 

! X 

1 

2. 55 






*A 

1 

. 26 

1 





*B 

221 

. 31 

196 

24 

1 



*F 

17 

. 18 

16 

1 




+ *F 

69 

. 20 

58 

5 

5 


1 

*S 

22 

3.39 





2 


48 

.31 

34 

14 




*b 

195 

.22 

179 

15 

1 



+ *b 

137 

. 23 

126 

11 




,Q 

1 

. 10 

1 





.B 

1 

. 06 

1 





.C 

5 

. 53 

2 

3 




+ .D 

3 

. 48 

1 

2 




.F 

2 

. 61 

1 

1 




. J 

22 

2. 07 

1 



6 

14 

.M 

3 

. 05 

3 





.N 

5 

.22 

5 





.U 

2 

. 16 

2 





.X 

4 

. 61 

3 


1 



@H 

8 

. 69 


7 

1 



@J 

3 

2. 63 





2 

@K 

1 

. 28 

1 





@R 

2 

. 28 

2 





@u 

1 

. 15 

1 





NJ 

1 

. 19 

1 





Tot. 

1090 

. 46 

862 

124 

30 

21 

25 

Percentages 

per bin 

79 

11 

2 

1 

2 


835.3 1734 


2809.0 1948 

769.2 2023 


9 

<1 


8 

<1 


6 

<1 


1 

<1 


4 

<1 


Times Mean ---Justification Response Time Distr. (10 char, intervals)-- 
Cmd. Exec. Time <0.5 < 1.0 < 1 . 5 < 2 . 0 < 2 .5 <3. 0 <3. 5 <4. 0 <4. 5 > = 4. 5 
J 28 1.63 11 13 3 1 

.J 22 2.07 1 6 14 1 

@H 8 . 69 7 1 ___ 


-Chars Mean 
/Sec Size 
422.9 693 

835.3 1734 

2809.0 1948 


Figure 68.5. Change Bin Width to .5 Second Intervals (concluded) 


Change Output Location to a Spooler File for Report 


♦stat SSTAT 

*out $s. #stat.report 

*dump _____ 

Figure 68.6. Commands to Change Output Location to a Spooler File for Report 
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SECTION 69 

FIND 

Standard Disk File Name: SSYSTEM.SYSTEM.FIND 
Process Revision Level: S0064,E01.000 (000) 

Description 

FIND is a process that finds a specified file when only the file name (or 
only a portion of the file name) is known. 

The file name specifications may have embedded question marks (?) to 
designate universal match (“don’t care”) characters. In addition, the file 
name may be specified with leading and or trailing asterisks that act as 
wild cards. Asterisks do not function as embedded wild cards. 

Here are some examples of specification strings and the files they would 
find: 

ju?t— to find all files beginning with ju and ending with t. For example, 

JUAT, JUBT. 

just*— to find all files beginning with just. For example, justify, jus¬ 
tice. 

*just —to find all files ending with just. For example, just, adjust, 
ojust. 

* just*— to find all files containing just no matter where it appears in the 
file name. For example justify, adjuster. 

Execution Syntax 

find can be run in one of two ways. 

If a parameter string is supplied, the program looks for the file as 
specified in the parameter string and then stops (Figure 69.1). 


;find header 
SSYSTEM 

SSYSTEM.EDITOR. HEADER 


Figure 69.1. Using find with a Parameter String 

If no parameter string is supplied, the program prompts for file specifica¬ 
tions until you enter I return I or IctrlI 0 (Figure 69.2). 


; f ind 

File to look for: header 
SSYSTEM 

SSYSTEM.EDITOR.HEADER 
File to look for: EOF! 


Figure 69.2. Using find without a Parameter String 
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FIND Error Messages 

The following messages may be given while you are using find. Most 

messages occur immediately following the command entry that generated 

the error. 

“case statement index out of range!”—Contact your Sll System Engineer. 

“Everything matches!”—You may have specified a string like “*”. 

“Fatal i/o error in [filename]”—There has been a hardware failure, the disk 
drive is not working properly, the file is full, etc. 

“Line too long”—Recheck the syntax of the command line. 

“No startup message found!”— find did not receive the startup message it 
expected from the Sll Command Interpreter. Try executing the pro¬ 
gram again. If you get this message a second time, contact your Sll 
System Engineer. 

“open failed for [filename]”—Either the file does not exist or you do not 
have the authority to access it. 
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SECTION 70 

FIXER 

Standard Disk File Name: SSYSTEM.SII.FIXER 
Process Revision Level: S0130.A06.005 (000) 

Description 

fixer allows you to recover the contents of damaged enscribe data 
files, fixer is not a file maintenance program, and need not be run on a 
regular basis. It should be run if error 59 (file is bad) occurs or when the 
system is halted in an unorderly fashion. 

fixer can be run while the system is up; however, it locks users out of 
files while it is working. If you must run fixer on a live system, notify users 
before executing the program. 

Execution Syntax 

fixer can be executed from Sll Command Interpreter. At the semicolon 
prompt enter fixer followed by the name of the file you wish to fix. 


; f ix e r(f i 1 e _ name| 

Figure 70.1. fixer Run Command Format 

When fixer is executed, the specified file is fixed and examined. If the 
file you have specified is a configuration file, the following prompt is 
displayed: 

This could be a configuration file. Should I fix the files it references? 


If you wish to run fixer on the configuration file only, respond to the the 
prompt by enter n and pressing Ireturn! , 

To fix all the files referenced by the configuration file, enter y and press 
IreturnI , This may take some time to complete. 

fixer prompts each time it locates an error. Respond to the prompt with 
y (yes) to fix the error. 

If the optional exclamation point is included, the program will read and 
examine every block of a record number or entry sequenced file. Normally 
this is not necessary. 


Example 

In Figure 70.2, fixer is being executed on the editorial header file 
(EDITOR.HEADER). 

; f i x e r e d i t o r. h e a d e r 

Figure 70.2. Run Command to Execute fixer on Editorial Header File 
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SECTION 71 

FSTAT 

Standard Disk File Name: SSYSTEM.SYSTEM,FSTAT 
Process Revision Level: S0111.A06.002 (000) 

Description 

fstat lists processes that have a named file open. If you cannot open a 
file or device because it is in use, fstat can tell you which processes have 
the file open. 



Figure 71.1. Processes Accessing a File 

If you attempt to fstat a file that does not exist, the semicolon prompt is 
returned. No error message is given. 


Execution Syntax 

fstat can be executed from Sll Command Interpreter. At the semicolon 
prompt enter fstat followed by the file name and IreturnI . 


;fstat 
00,091 

Sfl. #111 

SF111 254,255 

SOSP 

SSYSTEM .SII 

.ECONTROL 

;fstat 
00.091 
00,143 

Sfl. #rll 

SF111 254.255 

255,255 

SOSP 

SF1. #R11 

SSYSTEM .SII 
SSYSTEM .SII 

.ECONTROL 

. Cl 


Figure 71 .2. fstat for Coyote Terminal Files 


Example 

fstat can be run for any file on the system. Figure 71.3 illustrates fstat 
of the header file Ssystem.editor.header. Note that the entire file name 
must be specified if you are not using your defaults. 
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;fstat 

Ssystem.editor.header 




00,044 

SF405 

254,255 

STERM4 

SSYSTEM 

. SII 

.ECONTROL 

00,067 

SF406 

254,255 

$TERM4 

SSYSTEM 

. SII 

.ECONTROL 

00,069 

SPL2H 

254,255 

STERM4 

SSYSTEM 

. SII 

.JUST 

00,072 

SF414 

254,255 

STERM4 

SSYSTEM 

.SII 

.ECONTROL 

00,076 

SF402 

254,255 

STERM4 

SSYSTEM 

.SII 

.ECONTROL 

00,080 

SPPSJ 

254,255 

STERM4 

SSYSTEM 

. SII 

. JUST 

00,087 

SPSPL 

254,255 

STERM4 

SSYSTEM 

.SII 

.SPELL 

00,098 

SPVPT 

254,255 

STERM4 

SSYSTEM 

.SII 

.VPUTGET 

00,100 

SPSV1 

254,255 

STERM4 

SSYSTEM 

.SII 

. SAVE 


Figure 71.3. fstat for Ssystem.editor.header 



FSTAT Error Messages 

The following messages may be given while you are using fstat. Most 
messages occur immediately following the command entry that generated 
the error. 


“Child process abended”—Contact your Sll System Engineer. 

“cpu failed during processing”—The cpu failed while you were attempting 
to run FSTAT. 


“Illegal logical device number”—Recheck your entries on the command 
line. 

“Invalid format for file name”—You have entered the file name incorrectly. 

“i/o error for [filename]”—There has I he jware failure, the disk 

drive is not working propetlv, the file is full, etc. 

•open failed for [filename]”—Either the file does not exist or you do not 
have the authority to access it. 

“newprocess failed”— fstat cannot run. 


“No startup message found”— fstat did not receive the startup message 
it expected from the Sll Command Interpreter. Try executing fstat 
again. If you get this message a second time contact your Sll System 
Engineer. 

“Remote deviceinfo failed for”— fstat could not communicate with a re¬ 
mote system. 

“There is no device with that name”—You have specified an invalid device 
name on the command line. 


“Unable 

“Unable 


to open child”—Contact your Sll System Engineer. 

to send startup message to”—Contact your Sll System Engineer. 
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SECTION 72 

FTM 

Standard Disk File Name: SSYSTEM.SYSTEM.FTM 
Process Revision Level: S0216.A06.001 (000) 

Description 

ftm is a utility used on tns ii and txp based System/55s for temporary 
(in cpu memory) modification of data communication parameters of Sll’s 
ftms and xtm-iis. It also reports statistics on communications between 
ftms, xtm-iis and the cpus. (For tns i based System/55s, see xtm, 
Section 95.) 


CAUTION 

Improper use of this utility can cause ftms and 
xtm-iis to fail to communicate, and can also cause 
cpu halts. Secure accordingly 


Execution Syntax 

To run ftm, start Sll Command Interpreter and enter ftm in response to 
the semicolon prompt. 


; ftm 

Figure 72.1. Starting Process ftm 


Available Commands (by function) 

Control 

fc —Interactively edit last command 
help [command] —Print long command descriptions 
exit (or eof!) —Terminate execution of program 
debug —Debug ftmprocess 

Device/Line Selection 

device (name)—specify device to modify 
line (line) [, (line)]—Specify line or range of lines 
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Data Communications Parameters 

show —Show terminal parameters 
store —Store new parameters 
baud (rate)—Set baud rate 
RS232 —Use RS232 levels 
RS422 —Use RS422 levels 
direct —Direct connection to vdt 
modem —Switched connection to vdt 

Statistics 

trace (modifier)—i/o trace control 
listopens (subdevice)—List openers of a subdevice 
stats —Display line statistics 
clear —Clear line statistics 

dump (file)—Dump a trace data file 

* 

Detailed Command Explanations (listed alphabetically) 

The baud command changes the desired baud rate. The command has no 
effect until a store command is given. The rate given must be one of: 
45, 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 4800, 
9600, 19200 or 38400 baud. 

The clear command is used to reset the line statistics kept by ftmpro- 
cess. 

The debug command is used to debug ftmprocess. It should only be 
used by Sll personnel who know what they are doing. Used without 
forethought, this command can cause a processor halt. You must be 
signed on to super.super to execute this command. 

The device command specifies the name of the device to be modified. By 
default all lines are selected (see the line command). 

The direct command is used to specify that the vdt is connected directly 
to the ftm line. 

The dump command is used to display the contents of the specified trace 
data file. The file must have been created earlier using the trace disk 
command. 

The line command is used to select a single line or a range of lines to be 
modified by subsequent store and/or trace commands. 

The listopens command displays the openers of the specified subdevice. 

The modem command is used to specify that the vdt is connected through 
a RS232 modem to the ftm line. 

The RS232 command changes the line to use RS232 voltage levels. The 
command has no effect until a store command is given. 

The RS422 command changes the line to use RS422 voltage levels. The 
command has no effect until a store command is given. 
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The show command lists the configuration parameters for the first line in 
the set of selected lines (see the line command). 

The stats command is used to display the line statistics kept by ftmpro- 
cess. 

The store command stores the modified parameters for the selected lines 
, (see the line command). 

The trace command allows you to enable and/or disable the i/o trace 
feature of ftmprocess. The various modifiers that are supported are: 

off —Disable tracing 

packet —Trace incoming/outbound packets 
event —Trace packets and driver events 
eio —Trace eio commands and interrupts 
all —Trace everything 
dump —Dump the current trace table 
disk —Dump the trace table to disk 

Examples 

Check Statistics for FTM SF2 


>dev $f 2 

BAUD38400 RS422 DIRECT 
>stats 

Input 

Output 

Data transfers 

8074 

8914 

Data bytes 

113013 

617070 

Data packets 

8358 

10449 

Total packets 

54793 

66144 

Continued packets 

4 

1567 

Discarded/resent 

1 

0 

EIO instructions 

540019 


INTR awakes 

121390 


Resent bit map 

0000 


Max. sequenced packets 

36 


Max. resident memory 

4692 


> 




Figure 72.2. Commands to Check Statistics for ftm $F2 
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Trace Packets Sent to/from FTM $F4 and Dump on Screen 


>device $F4 
>trace packet 
>trace dump 

08/19/85 13:32:26.77 
0000/0000, P# = 15 

Line 

03/0 

PACKET IN, SIZE = 

04/000, 

FUNC = 

02, C/S/A = 0/0/0, 

WORDO/1 = 

08/19/85 13:32:26.77 

Line 

03/0 

PACKET OUT, SIZE = 

04/000, 

FUNC = 

01, C/S/A = 0/0/0, 

WORDO/1 = 

0000/0000, DATA = 00000000 







08/19/85 13:32:15.09 

Line 

12/0 

EVENT, STATE = 2, 

SUBSTATE 

= cooo, 

EVENT = 3 


08/19/85 13:32:15.09 

Line 

12/0 

EIO, PC = %010444, 

COMMAND 

= 2DBC, 

PARM = 000F, DEVSTAT = 0000 

08/19/85 13:32:15.09 
0000/0000, P# = 15 

Line 

12/0 

PACKET IN, SIZE = 

04/000, 

FUNC = 

02, C/S/A = 0/0/0, 

WORDO/1 = 

08/19/85 13:32:15.09 

Line 

12/0 

EIO, PC = %004460, 

COMMAND 

= 33BC, 

PARM = 000F, DEVSTAT = 0200 

>trace off 

> 









Figure 72.3. Trace Packets Sent to/from ftm $F4 and Dump on Screen 


Check Current Parameters for FTM SF5 and List 
Processes That Have Given Coyote Channel Open 


>device Sf5 
BAUD38400 RS422 DIRECT 
>listopens #r03 
OCB 01, PPID = SF503 
> 

Figure 72.4. Check Current Parameters for ftm $F5 and List Processes That Have Given Coyote Channel Open 


Change Parameters for All Channels of FTM SF1 


>device SF1BAUD38400 RS422 DIRECT 

>baud 1200 

>modem 

>RS232 

>store 

Figure 72.5. Change Parameters for All Channels of ftm $fi 
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SECTION 73 

LINKUP 

Standard Disk File Name: SSYSTEM.SYSTEM.LINKUP 
Process Revision Level: S0065.A06.004 (002) 

Description 

linkup allows you to obtain information about the program file as de¬ 
scribed in “Process Revision Levels.” 

Process Revision Levels 

All Sll processes are identified by a product number, which includes 
Process Revision Level information. The string consists of four fields: 

1. The product number. This number is composed of a letter that identifies 
the origin of the product and a four-digit software product number. 
There are three types of product numbers, as follows: 

t for Tandem product, with the four-digit Tandem product number; 
s for Sll product, with a four-digit Sll product number; and 

u for unsupported Tandem products (for which Sll has the source), with 
a four-digit Sll product number. 

2. The lowest level Tandem monitor revision at which this process will run. 
This field is changed only when a Tandem monitor is installed that 
requires a change to the process in order to make it run on the new 
monitor release. All processes start with eoi in this field to reflect that 
monitor release. 

3. A three-digit Version Number (initially zero), which is incremented 
whenever a “significant” change is made to a process (e.g., changes 
that make it incompatible with the previous version, changes that would 
require a new release of the documentation, etc.). Generally, a bug fix 
is not considered a version level change, but rather an edit level change 
(reflected in the next field). The edit level is reset to zero whenever the 
version level is incremented. 

4. A three-digit Edit Level (initially zero), which is incremented every time 
a change is made to a process. This necessitates changing the linkup 
for a process each time a change is made to a process. In addition, the 
Revision History of the process (maintained in the source) is updated, 
noting the new Edit Level with an explanation of the change. 

Product Number Example 

S0009.E01.001 (008l 

S0009. identifies this process as Sll software product #9. 

eoi . identifies Tandem monitor revision eoi as the lowest Tandem monitor 
revision with which this process is compatible. 
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001 is the current version level of the process, the first significant change 
to it. 

(008) is the current edit level of the process, the eighth change since 
version 001 took effect. Edit levels reflect minor changes. 

Execution Syntax 

Revision level information is contained in the code of all processes in 
System/55. This information is user-accessible so that at any time you can 
determine what version of a process is installed at your site. Knowing the 
revision level of a process is especially important for troubleshooting in 
case of difficulties that may result from the incompatibility in versions of 
two processes. It is also essential for installing updates to a site’s software. 

To determine the version and edit level of a program in your system, 
execute the following in Sll Command Interpreter (be sure to enter the full 
program file name in the linkup info command; cupdateh is used as an 
example. System and process revision information is in boldface.) 


;1inkup_ _ info $system.sii.cupdateh 
Object file name is $SYSTEM.SII.CUPDATEH 
Main procedure is CUPDATEH 
9902 words of global data 
11 data pages requested 
18360 words of user code 
72 words of PEP 

37557 is execution address (octal) 

System revision level: SII.E02 Sept 1981 
Process revision level: S0009.E01.001 (019) 
Build date: 10/30/81 10:37:13 


Figure 73.1 . linkup info for cupdateh 
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SECTION 74 

MAINT Process 

Standard Disk File Name: SSYSTEM.SYSTEM.MAINT 
Process Revision Level : S0066.E03.003 (007) 

Description 

maint is a utility process used to maintain baskets and desks. 

It is intended to be run any time the sorting order or sorting field of a 
basket or desk changes, maint is also used to fix basket or desk definition 

files after a change is made to a Q-field name. 

% 

When maint processes stories, it recalculates offsets and sequencing 
information and writes new headers for all stories affected. When it is run 
after a Q-field change, maint simply updates offsets and sequencing infor¬ 
mation. 

MAINT User Identification 

The maint process logs on as user maint, so program b (busy) will 
know who is updating data. If a story to be updated is locked, maint skips 
the story and sends a message informing the operator what is being done. 

Basket and Desk Sorting 

Basket and desk profiles contain the following line: 

Sorted (L,F,A, or R) _ by (field name) _ 

This is where the user specifies the order in vyhich the contents of the 
basket or desk will be sorted. The four options are as follows: 

l —last in, first out (lifo) 
f —first in, first out (fifo) 
a —alphabetically by the specified field name 
r —in reverse alphabetical order by the specified field name 

If a basket or desk is to be sorted in alphabetical or reverse alphabetical 
order, the name of a Q-fieid by which to sort must be entered. Typical 
entries are story'name or topic. Refer to the sections on the header 
structure in the Index of Record Structures (S55-007) for listings of all 
available fields. 

The contents of baskets and desks are sorted as initially specified in the 
basket and desk profiles until the sort method is changed. All stories 
entered after the change will be sorted according to the new method, but 
the stories filed before the change will still be sorted according to the 
original method unless maint is run against the altered basket. 

If the user wants to have all the stories in the desk or basket sorted by 
the new method, maint should be run against the basket or desk to 
reorder all the stories. 
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Execution Syntax 

The maint process is run from Sll Command Interpreter: 

;maint 

Exiting MAINT 

To exit maint enter exit at the question mark prompt or press |ctrl| [y], 

MAINT Help 

The help command provides a short listing of all the maint commands. 
Execute maint as described above and enter help after the ? prompt, as 
shown in Figure 74.1. 


?help 


BASKET file name 

reorder basket 

HELP [command] 

print long command description 

EXIT (or EOF!) 

terminate execution of program 

DESK file name 

reorder desk 

FIX basket or desk 

recalc offset in desk or basket file 

BLIND 

delete bad blind box and reply records 

TEAR 

delete bad tear sheet records 

CLASS name or number 

reorder .classifieds 

LOWERBOUND 

set blind box lower boundary 

UPPERBOUND 

set blind box upper boundary 

DUMP 

delete out of date dump item records 

STATS 

delete excess class stats records 

TRACKING 

maintain ad tracking file records 

EXTRACTS [fileset] 

build header extract records 


Figure 74.1. Short help Directory for maint 


Examples 

Reordering Baskets and Desks 

If a Q-field is changed in a basket or desk, or the order of story sorting is 
altered, maint will reorder it by rewriting the headers of stories in the 
basket or desk. Enter 

CE (basket name) 
or 

?DESK (desk name) 

When you enter the basket or desk command, there is a slight pause 
while maint reorders the file. When the process has finished, maint in¬ 
forms you of the number of stories affected by the resorting: 

?n stories resorted 

Fixing Baskets and Desks 

If a structure is changed, thereby changing byte offsets and byte counts, 
maint will fix the baskets or desks by rewriting record definitions. Enter: 

?FIX BASKET 

or 

?FIX DESK 
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Building Header Extracts 

The command extract (fileset) constructs and writes records to header 
extract files. 

Advertising Commands 

The remaining maint commands— class, lowerbound, upperbound, 
dump, stats, and tracking —apply to advertising systems only. 

MAINT Error Messages 

The following messages may be given while you are using maint. Most 
messages occur immediately following the command entry that generated 
the error. 

“Abbreviation not unique”—The command abbreviation is not understood. 
Add a sufficient number of letters to make the command recognizable 
to the system. 

“case statement index out of range”—There is a problem with the maint 
process. Contact your Sll System Engineer. 

“Command parameter missing"—A required string modifier is missing. 
Request detailed help for the command. 

“Couldn’t change to network form”—System was unable to access network 
mode. 

“Fatal i/o error in [file name]”—There has been an irrecoverable error. 

“Header update failed”—Failed to accept header resequencing command. 
Try again. The header may have been busy. 

“Invalid command”—The command is not recognized. Enter help for a list 
of acceptable commands. 

“Key position or position failed for [file name]”—Probable hardware failure. 

“Missing system identifier”—The correct system not correctly specified. 
Ensure you are in the same system you are attempting to run maint 
against, or that the correct system is specified in the configuration file. 

“More than 10,000 active ads, class not sorted”—Input has exceeded a 
programmed limit. If this is a problem, contact your Sll System Engi¬ 
neer. 

“No config file entry found: blind box”— There is no configuration file 
entry for the Blind Box file or it is improperly defined. See your System 
Manager. 

“No config file entry found: tear sheet”— There is no configuration file 
entry for the Tear Sheet file or it is improperly defined. 

“No configuration file”—The configuration file cannot be found. 

“No param expected, was ignored”—Improper or superfluous parameter 
entered. Enter help for correct placement of parameters. 

“No startup message found”—The system startup message was not re¬ 
ceived. Start maint again. 

“open failed for [file name]”—Either the file does not exist, or you do not 
have the authority to access it. 

“Sign on failed, maint in use”—Another user is running maint on the same 
basket. Two users may not run maint on the same basket simulta- 
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neously. Discuss the difficulty with the other user; you may be work¬ 
ing at cross purposes. 

“Story [name and reason] was skipped”—The story was skipped when 
resequencing was attempted. Try again after a short wait. 
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SECTION 75 

MUX 

Standard Disk File Name: SSYSTEM.SYSTEM.MUX 
Process Revision Level: S0112.A06.003 (000) 

Description 

MUX is a utility used for temporary (in cpu memory) modification of data 
communication parameters of SH’s tcus, vcus, and Synchronous 
Coyotes. It also reports statistics on communications between these de¬ 
vices and the cpus. (See ftm, Section 72; xtm, Section 95, and stty, 
Section 88 for information on other Sll data communication utilities.) 


CAUTION 

Improper use of this utility can cause these devices 
to fail to communicate and can also cause cpu 
halts. Secure accordingly 


Execution Syntax 

To run mux, start Sll Command Interpreter and enter mux in response 
to the semicolon prompt. 

; mux 

Figure 75.1. Starting Process mux 


Available Commands (by function) 

Control 

fc —Interactively edit last command 
help [command] — Print long command descriptions 
exit (or eof!) —Terminate execution of program 
debug —Debug muxprocess 

Device/Line Selection 

line (name)—Specify line (tcu, vcu or synchronous Coyote) to alter. 

Data Communications Parameters 

show— Show terminal parameters 
SET(line type)—Set line type (vcu/tcu 'sync) 
oowNT(vdt) —Down a single VDT 
up (vdt) —Up a single VDT 
baud (rate;—Set baud rate 


75.1 





MUX 


Utilities 


Statistics 

stats —Display line statistics 

Detailed Command Explanations (listed alphabetically) 

The baud command is used to set the baud rate used by muxprocess to 
determine how long to wait for a response from the Coyote, vcu or 
tcu. Baud rates must be between 1 .2 KB and 80.0 KB. 

The debug command is used to debug a muxprocess line. This should 
only be used by Sll personnel who know what they are doing. Used 
without forethought, this command can cause a processor halt. The 
user must be signed on to super.super to use this command. 

The down command is the equivalent of the pup down command, except 
that it only downs the specified vdt. The vdt name is specified 
normally, with the line name and the period removed (for example, 
#L01). 

The line command is used to select a line for the show and set com¬ 
mands. 

The set command allows the user to change the line type of the current 
line. The line must have been DOWNed by the user, or muxprocess 
will reject the command. 

The show command displays the line parameters for the current line. The 
parameters include the line type (vcu, tcu or synchronous Coyote), 
the read timeout, the session timeout and the minimum baud rate. 

The stats command displays the line statistics for all muxprocess lines. 
The list contains the name of the line, the number of good sessions, 
the percentage of bytes transferred that were data bytes (as opposed 
to protocol overhead), the number of bad sessions, the number of 
naks received, the number of bcc errors detected and the number of 
overrun errors detected. 

The up command is the equivalent of the pup up command, except that it 
only ups the specified vdt. 

Examples 


Check Statistics of TCU SA1 


>line SAI 
>stats 







Line 

Good 

Byte 

Bad 

NAK 

BCC 

Overrun 

Name 

Sessions 

% 

Sessions 

Count 

Errors 

Errors 

SAI 

> 

715452 

27 

45 

3 

1 



Figure 75.2. Commands to Check Statistics of tcu Sai 
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Change TCU Line to Support Synchronous Coyote 


>line SA1 
>show 

Currently configured for a TCU 

Minimum baud rate is 80.0 KB. session timeout = 60.00 seconds. 

>down SA1 
>set SYNC 
>show 

Currently configured for a SYNC COYOTE 

Minimum baud rate is 80.0 KB. session timeout = 60.00 seconds. 

> 

Figure 75.3. Commands to Change tcu Line to Support Synchronous Coyote 
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~ SECTION 76 

_PERCENT 

Report iext Storage !n Use 

Standard Disk File Name: SSYSTEM.SYSTEM.PERCENT 
Process Revision Level: S0067.E03.000 (006) 

Description 

percent is a non-interactive process that searches text files and reports 
the percentage of text file storage currently in use. System/55 stores bytes 
of information on pages, and stores pages in extents. The extents com¬ 
prise a data file. 


How Text File Storage is Used 

Text file records are linked together in a chain. The front chain is a list of 
records immediately available for storing stories and ads. The rear chain 
contains all oops copies that have been created. Text storage areas that 
have never been used are called ‘‘virgin free records.” 

Text file storage space is used in the following order: 


1. front chain 

2. rear chain, if old enough 

3. virgin free records 

If all of this storage space is used, the system begins to write over the 
rear chain regardless of story age. 


When a story is filed, the system first searches the front chain for a place 
to store it. If no records are available there, the system tries to store it in 
the rear chain. When searching the rear chain the system looks for the 
oldest story. If it is old enough to be purged (usually 24 hours), the new 
take is put in its place. 


If the front chain is full and nothing in the rear chain is old enough to 
purge, the system begins using virgin free records. As these records are 
filled, the system automatically attempts allocation of another extent. 

When all extents have been allocated, and there are no virgin free 
records remaining, the system begins writing over oops copies regardless 
of their age. If this area of text storage is exhausted the system can no 
longer store new takes; reporters and ad takers can no longer file their 
work. When this happens, operations come to a halt. 


Text file storage availability changes constantly. It may approach capac¬ 
ity during periods of high system activity as reporters begin filing stories, 
salespeople take ads, and wire service activity increases. Later, when 
deadlines have passed and the paper has gone to press, storage availabil¬ 
ity increases as input frequency declines and the system purges old takes. 


percent allows you to monitor these changes and provides valuable 
information that can be used to manage text file storage most effectively. 
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Execution Syntax 

Enter Sll Command Interpreter and enter percent at the semicolon 
prompt. There are no commands or parameters. A typical report is illustrat¬ 
ed in Figure 76.1. 


;percent 

Text file information for Editorial 
Text file $DATA.PDQB.ETEXTF is 60 % full 
0 records are free in front chain 
4,732 records are free in rear chain 
30,412 records are virgin free records 
54,855 records are in use out of 89,999 

Text file information for Classified 
Text file SDATAl.PDQB.CTEXTF is 74 % full 
0 records are free in front chain 
22,160 records are free in rear chain 
4,682 records are virgin free records 
79,422 records are in use out of 106,264 

Figure 76.1. percent Listing of Text File Record Availability 


Example 

In Figure 76.1, there are no records remaining in the front chain, and the 
system is writing over old oops copies. The percent report in Figure 76.2 
shows a text file approaching capacity (assuming that all extents have 
been allocated). 


Text file information for Editorial 

Text file SDATA.PDQB.ETEXTF is 92 % full. 

0 records are free in front chain. 

7,198 records are free in rear chain. 

0 records are virgin free records. 

82,801 records are in use out of 89,999 

V 

Text file information for Classified 

Text file SDATAl.PDQB.CTEXTF is 99 % full. 

0 records are free in front chain. 

1,061 records are free in rear chain. 

0 records are virgin free records. 

105.203 records are in use out of 106.264 



Figure 76.2. percent Listing of Text Fiie Record Availability 


If percent reports that text file storage is nearing capacity, you can 
spike stories or change story expiration time to permit automatic purging to 
begin. If percent consistently shows text file usage approaching 100 
percent during periods of high system activity, additional text storage may 
be needed. Refer to the Tandem “GUARDIAN Operating System Com¬ 
mand Language and Utilities Manual”, specifically the '‘FUP” utility, for 
information on allocating additional file extents and creating a larger file. 
Since there are many ways to add additional text space (multiple text files, 
increasing the size of a single file), you may wish to contact Sll to deter¬ 
mine which would be best for your site. Sll can help you determine your 
text file requirements as well as give you specific procedures for your site. 
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SECTION 77 

PIPE 


Standard Disk File Name: SSYSTEM.SYSTEM.PIPE 
Process Revision Level : S0327.E06.000 (000) 


Description 

The pipe utility is used to move stories from one system to another 
without the use of a real tape drive, it stores data from one tape process 
(the writer) and forwards it to another tape process (the reader). Currently 
pipe does not reply to the writer until the data has been passed on to the 
reader. The program was written for use through the device command of 
the tape utility version soo84.eo3.ooi ( 025 ) or later. (See tape, Section 
89). 


Execution Syntax 

To run pipe, start Sll Command Interpreter and enter pipe in response to 
the semicolon prompt. 


;Ripe _ 

Figure 77.1. Starting Process pipe 



Example 

In the example in Figure 77.2, explanatory text is provided in italic. 


;pipe / name Spipe,nowait / 

Run PIPE program 

;tape /name Ssrc, out $s. #tape.src/ 

Run TAPE to generate data (SSRC) 

TAPE -- SII tape utility program 

♦set dev Spipe 

Tell SSRC to write data to SPIPE 

SSRC; TAPELEN has been reset to 4096 

♦system siip 

♦tapeset pipe test 

♦path ba national 

♦save 

Tell SSRC to start saving data. The SAVE won't proceed until the other TAPE program is run. 

Hit COMMAND so we can run the other TAPE 
;tape /name Sdst, out Ss. #tape.dst/ 

Run TAPE to receive data (SDST) 

Figure 77.2. Using pipe to Move Stories from One System to Another (partial) 
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TAPE -- SII tape utility program 
*set dev Spipe 
Tell SDST to read data from SPIPE 

$DST; TAPELEN has been reset to 4096 

♦system siit 

♦tapeset pipe test 

♦set wholeheader on 

♦add 

Tell SSRC to start adding stories. SSRC and SDST write/read data using the SPIPE process. 
9 stories saved. 

SSRC tells that its done, and prompts. 

♦EOF! 

9 stories restored. 

SDST tells that its done, and prompts. 

♦EOF! 


Figure 77.2. Using pipe to Move Stories from One System to Another (concluded) 
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SECTION 78 

PRINT 

Standard Disk File Name: SSYSTEM.SYSTEM.PRINT 

Description 

The print process is used to write a message to a device—as soon as 
the device is available. 


Execution Syntax 

print is executed from Sll Command Interpreter. At the semicolon 
prompt, enter print followed by the name of the device and the message 
that is to be written to the device. 

The example in Figure 78.1 illustrates the format for the print run 
command as it might be used to write to a line printer. 


;print /out $1p/ This is a test 

Figure 78.1. print Run Command 


PRINT Error Messages 

When an error occurs, print logs the error message on the vdt from 
which the process was executed followed by the Tandem error number 
(represented by “nn” below). For an explanation of the error, at the semico¬ 
lon prompt enter the error number followed by [return]. 

“Cannot open log file, error: nn” 

“Cannot open Sreceive file, error: nn” 
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~ SECTION 79 

PRINTH 

Standard Disk File Name: $SYSTEM.SYSTEM.PRINTH 
Process Revision Level: S0000.E05.000 (000) 


Description 

printh writes a high priority message to a device (for example a line 
printer or system console typer). High priority messages cause low priority 
messages to be bumped. Thus, with this program, you can write to a 
terminal even if the SI I Command Interpreter is prompting. However, 
printh will not interrupt econtrol to write to a vdt. 


Execution Syntax 

printh is executed from Sll Command Interpreter. At the semicolon 
prompt, enter “printh” followed by the name of the device and the message 
that is to be written to the device. 

The example in Figure 79.1 illustrates the format for the printh run 
command as it might be used to write to a line printer. 


; P?.in^h_/_put_$lp/..This_.is__a..test 


Figure 79.1. printh Run Command 


PRINTH Error Messages 

The following messages may be given while you are using printh. Most 
messages occur immediately following the command entry that generated 
the error. 

“case statement index out of range”—Contact your Sll System Engineer. 

“Fatal i/o error in [filename]”—There has been a hardware failure, the disk 
drive is not working properly, the file is full, etc. 

“No startup message found”— printh did not get the startup message it 
expected from the Sll Command Interpreter. Try executing printh 
again. If you get this message a second time, contact your Sll System 
Engineer. 

“open failed for”—Either the file does not exist or you do not have the 
authority to access it. 
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SECTION 80 

PROGREV 


Standard Disk File Name: SSYSTEM.SYSTEM.PROGREV 
Process Revision Level: S0000.E01.000 (000) 


Description 

progrev facilitates software updates at your site. SI I uses the file 
created by progrev to determine the software revision level of processes 
at your site. 

Prior to running progrev, you must purge data from the progrev data 
file (Figure 80.1). 


;fup purgedata Ssystem.sysdata.progrev 

;fup purgedata Ssystem.sysdata.progrevO (this is the alternate key file) 

Figure 80.1. Purging Data from the progrev Data File 


Next, use the fup info command to make certain that all the data has 
been purged (Figure 80.2). Check the eof; be sure it reads 0. If it does not, 
you have not purged the data from the file. 


:fup info sysdata.progrev,detail 
;fup info sysdata.progrevO.detail 


Figure 80.2. fup info Command for progrev Data File 


Execution Syntax 

The run command for progrev is illustrated in Figure 80.3. 

•.progrev out Ssystem. sysdata. progrev Ssystem. system. *: Ssystem. sii. *; ! error 100 

Figure 80.3. PROGREV Run Command 

The out file (Ssystem.sysdata.progrev) is the datafile set up by SII 
that allows you to display on the screen (using the list progrev), current 
information for software on your system. 

The “! error 100” option allows progrev to continue running until it 
reaches 101 errors; then it will stop. 

If you have subvolume(s) on disk that you would like to check with 
progrev, you may add them to the run command. Make sure to use a 
semicolon to separate the different subvolume(s). 
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Obtaining Coyote Build Revision Information 

To create an obey file for use in obtaining Coyote revision information, 
use the commands illustrated in Figure 80.4. 


;edit obey.coydata 

SSySTEM.OBEY.COYDATA DOES NOT EXIST, SHALL I CREATE IT? y 
*a 1 

1 copy ctl,,a,count 1 

2 copy ct4,,a,count 1 

3 // 

*exit % 

:edit obey.coyrev 

SSYSTEM.OBEY.COYREV DOES NOT EXIST. SHALL I CREATE IT? y 
*a 1 

1 volume m68 

2 fup /in obey.coydata,out $s. #coyrev.sitename/ 

3 // 

*exit 

Figure 80.4. Obey File to Obtain Coyote Build Revision Levels 

This obey file should be run each time you run progrev so that you get 
current data. 

To execute the obey file: 

;comint /in obey.coyrev/ 

When creating an obey file for use at your site, make certain to change 
sitename to your site name, and remember to add the Coyote builds in use 
at your site. Lines 1 and 2 in the obey file you create should be repeated 
for each file you currently have in your M68 subvolume. 


;files m68 
SSYSTEM.M68 

CT1 CT4 CTQB CTS FCTS FCT1 FCT4 FCTQB SCT1 

Figure 80.5. files Command to List Coyote Builds 

Use the files command to get a list of files in the M68 subvolume at 
your site (Figure 80.5). The files are described below. 

% 

FILE DESCRIPTION 

cti Coyote 1 running through an xtm or tcu. 

CT4 Coyote iv running through an xtm or tcu. 

ctqb Coyote qb running through an xtm or tcu. 
cts Coyote std running through an xtm or tcu. 

fcts Coyote std running through an ftm. 

fcti Coyote 1 running through an ftm. 

fct4 Coyote iv running through an ftm. 

fctqb Coyote qb running through an ftm. 

scti Coyote 1 running through a byte sync. 
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SECTION 81 

PSTAT 

Standard Disk File Name: SSYSTEM.SYSTEM.PSTAT 
Process Revision Level: S0113.A06.003 (000) 

Description 

pstat displays the contents of its process control block and lists all files 
the specified process has open. If the file is open for no-wait i/o, pstat lists 
the information on outstanding requests for the file. 


A-00078 



Figure 81.1. Files Accessed by a Process 

Execution Syntax 

pstat is executed from Sll Command Interpreter. At the semicolon 
prompt enter pstat followed by the name (or cpu, pin number) of the 
process for which you wish to display statistics. 

In Figure 81.2, pstat has been executed for a Coyote terminal process. 
Explantions of the information in the pstat listing have been provided in 
italic. 

;pstat $f312 

Process SF312 (2,40) was created by: $ZEUS 

The process ID and the ancestor of the process 

Program file name is SSYSTEM.SII.ECONTROL 

The program that was run to create this process 

Creation ID = 254,255 and process ID = 255,255 

Every process runs as a Tandem user; this line indicates that SZEUS was 254,255 when it created the process and that now the pro¬ 
cess runs as a 255,255 

Figure 81.2. pstat for Coyote Terminal Process (with Explanations, partial) 
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Creator may stop process, and no one has tried. • 

Waiting for LREQ, LDONE 

Will time out in 18.25 seconds 

Initial priority was 140 and current priority is 140 
S = 042345 P = 100400 E = 002407 L = 042344 
LISTEN LCB's reserved: 0, LINK LCB's reserved: 0 
LISTEN LCB'S in use: 0, LINK LCB'S in use: 1 
1/0 was last done to file 17, last error was 40 

File 0 is $RECEIVE (R/W, S) 

this allows this process to communicate with all other processes 

Request 1 is READUPDATE for 2048 bytes 

File 1 is $F3. #L12 (R/W, S) 

$F312 has opened a file to the left side of this terminal 

File 2 is $F3.#R12 (R/W, E) 

SF312 has opened a file to the right side of this terminal 
S = means more than one can open this file 
E = this file is exclusive: can only read or write if file is closed 
R = can’t write to this file 
P = privileged file 

Request 1 is WRITEUPDATE for 0 bytes 
File 4 is $EFIO (R/W, S) 

File 5 is SEGOD (R/W, S) 

File 6 is SEVPM (R/W, S) 

File 7 is SEGOD (R/W, S) 

EGOD is open twice to handle requests from each side cf the terminal 

File 8 is SEMSG (R/W, S) 

File 10 is SEVPT (R/W, S) 

File 11 is SEVGT (R/W, S) 

File 12 is SDATA.EDITOR.HEADER (R/W, S) 

File 13 is SEUPD (R/W, S) 

File 14 is SDATA.EDITOR.STRINGS (R/W, S) 

File 15 is SETRl (R/W, S) 

File 16 is SDATA.EDITOR.XBASKET (R/W, S) 

File 17 is SSTAT (R/W, S) 

File 18 is SDATA.VPEND.F312 (R/W, P) 

P in the parentheses above means that only this process can get into this file, which is a temporary virtual pending file. 

File 19 is SEFIL (R/W, S) 

All of these files are open in order to run terminal SF312. When signed off, the files to both sides of the terminal are open, as well as the 
prompt process and SEFIO, which saves disk I/O. 

Figure 81 .2. pstat for Coyote Terminal Process (concluded) 
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Example 

PSTAT can be very useful in troubleshooting system (process) prob¬ 
lems. For example, $aopr normally (Figure 81.3) has open $osp, $emsg, 

and $S YSTEM. SYS DATA. AOPR LOG. 


;pstat Saopr 

Process $AOPR (1,23 & 0,15) was created by: DEMO.03,008 

SAOPR was created by SZ000 

Program file name is $SYSTEM.SYSTEM.AOPR 
Creation ID = 255,255 and process ID = 255,255 
Creator may stop process, and no one has tried. 

Waiting for LREQ 

Will time out in 24.37 seconds 

Initial priority was 190 and current priority is 190 
S = 005565 P = 100400 E = 002407 L = 005564 
LISTEN LCB's reserved: 0, LINK LCB's reserved: 0 
LISTEN LCB’S in use: 0, LINK LCB's in use: 0 
I/O was last done to file 2, last error was 40 
File 0 is SRECEIVE (R/W, S) 

Request 1 is READUPDATE for 200 bytes 
File 1 is $0SP (R/W, S) 

File 2 is SSYSTEM. S’SSDATA. AOPRLOG (R/W, S) 

File 3 is $0§P (R/W, S) 

File 4 is SEMSG (R/W, S) 

Figure 81.3. pstat for the aopr Process 


If a pstat of $aopr showed that Semsg was not open, it would explain 
why system messages are not being displayed on terminals. 


A pstat showing that Saopr does not have Ssystem.sysdata.aopr- 
log open would explain why a listing of the aopr log ( |cmd| fxT aopr log) 
contained no new entries. You would need to stop Saopr, then restart it 
using its startup obey file (see Section 99 for the text of this file). 


;comint /in Ssystem.obey.strtaopr/ 


PSTAT Error Messages 

The following messages may be given while you are using pstat. Most 
messages occur immediately following the command entry that generated 
the error. 


"Fatal i/o error in [file name]”—There has been a hardware failure, the disk 
drive is not working properly, the file is full, etc. 

“No Startup message found”— pstat did not receive the startup message 
it expected from the Sll Command Interpreter. You may get this 
message if you press Icmoi before pstat executes. Try executing 
pstat again. If you get this message a second time, contact your Sll 
System Engineer. 


“No such cpu, pin”— The cpu, pin you specified is not running. For exam¬ 
ple, you would get this message if you entered pstat 3,4 on a two 
processor system. 



u 


No such process-pair name”—You have entered an invalid process-pair 
name in the pstat command line. 
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“open failed for [filename]”—Either the file does not exist or you do not 
have'the authority to access it. 


“pstat must run in same system as”—You cannot pstat a process on a 
remote system. You must run pstat on that remote system. 


“Unable to new process into correct cpu”—pstat couldn’t get to the cpu 
in which the process is running. 
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SECTION 82 

QREQUEST 


Standard Disk File Name: SSYSTEM.SII.QREQUEST 
Process Revision Level: S0295.E01.000 (005) 


Description 

The qrequest utility allows you to perform request functions (see 
Section 85) for day-to-day maintenance and operations with English state¬ 
ments. 


The Help Command 

To display general information about qrequest and its functions, enter 
Sll Command Interpreter ( 1cmD i ll) and type: 

;sii.qrequest.help 


Execution Syntax 

The general syntax of the qrequest command is as follows: 

;sii.qrequest system name: request function 

For example: 

;sii.qrequest siic; initialize cupdateh 

to initialize the cupdateh processes. 

Each of the available qrequest functions is described in Table 82.1. 



Table 82.1 


Process Requests 

QREQUEST FUNCTION 

RESULT 

INITIALIZE CUPDATEH 

Initializes cupdateh, the advertising header update process (see re¬ 
quest Scupd. 120 . Section 85). You must execute this request whenev¬ 
er an Advertising system record (for example, the rate table or class 
control record) is changed. Note that you need only make one qrequ¬ 
est to perform this function for all cupdateh processes specified in the 
configuration file. 

KILL CUPDATEH 

Stops all cupdateh processes so a new one may be installed (see re¬ 
quest Scupd. 122 , Section 85). 

INITIALIZE UPDATEH 

Initializes updateh. the editorial header update process. Note that you 
need only make one qrequest to perform this function for all updateh 
processes specified in the configuration file. 

KILL UPDATEH 

Stops all updateh processes so a new one may be installed (see re¬ 
quest Seupd.i22, Section 85). 

INITIALIZE FIO 

Initializes the fio process (see request $efio.i 9, and request 

Scfio. 19. Section 85) running on the specified system. 
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Table 82.1 (continued) 

Process Requests 

QREQUEST FUNCTION 

RESULT 

INITIALIZE ALL 

Sends an initialization request to all cupdateh, updateh, and fio pro¬ 
cesses on the specified system. 

STOP SYSTEM 

START SYSTEM 

Stops the specified system (see also, request $zeus,i2, Section 85). 

Restarts the specified system (see also, request $zeus,ii , Section 

85). 

START SERVERS 

abort story name/number 

Restarts the server processes on the specified system. 

Sends an abort request to $egod or Scgod so that a background pro¬ 
cess for the given ad or story can be aborted. (See also request 
$egod,ii 2, and request $cgod,ii 2, Section 85) 

INITIALIZE LINAGE 

UPDATE LINAGE 

Reinitializes the advertising linage process. 

Instructs the linage process to write all of its internal counters back to 
the linage records. 

LINAGE STATS 

Displays the last initialization date and time and the number of current 
linage records. 

INITIALIZE CREDIT CHECK 

CREDIT CHECK STATS 

Reinitializes the credit check process. 

Dumps program statistics for the credit check process to the out file 
specified for this program. 

CUPDATEH STATS 

FIO STATS 

Prints statistics for all cupdateh processes. 

Prints statistics for all fio processes. 
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SECTION 83 

READYQ 

Standard Disk File Name: SSYSTEM.SYSTEM.READYQ 
Process Revision Level: S0114.A06.001 (000) 


Description 

readyq displays the program file names of the processes running or 
waiting to be run for the processor on which it is executed. A job is in the 
ready queue if: 

1. It is running, 

2. it is ready to run but is waiting for the cpu, or 

3. it is waiting for a page to be paged in. 

Processes waiting for i/o or waiting for interprocess communications are 
not in the ready queue. Normally there are very few processes in the ready 
queue. 


Execution Syntax 


readyq can be executed from the SI I Command Interpreter. At the 
semicolon prompt enter readyq followed by the cpu for which you wish to 
see statistics displayed (Figure 83.1). 


If you do not specify the cpu, readyq will run in the first available cpu. 


;readyq /cpu 0/ 




Pri LCB 

Name 

Program 

File Name 

00,037 170 005 

SISPL 

SSYSTEM 

.SYSTEM . 

SPOOL 

00,023 170 006 

SSPLS 

SSYSTEM 

.SYSTEM . 

SPOOL 

00,032 146 001 

$EXOR 

SDATA 

. M68 

M68LINK 

00,082 121 002 


SSYSTEM 

.SYSTEM . 

TAL 

00,066 120 003 

SINTK 

SSYSTEM 

. SII 

INTAKE 


Figure 83.1. readyq Listing 


Note that processes are in order by priority in the ready queue. A 
process that is hogging the cpu should be first or second in the queue. 
Ordinarily it is a good idea to run readyq two or three times to determine 
which process is consistently monopolizing cpu time. System processes, 
for example, the memory manager, disk processes, and so on, ail run at 
priorities above 200. Since readyq runs at less than 200, no system 
processes can ever be caught in the ready queue by readyq. User pro¬ 
grams running at a higher priority than readyq will be listed only if they are 
waiting because of a page fault. 
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SECTION 84 

REAUDIT 

Standard Disk File Name: SSYSTEM.SYSTEM.REAUDIT 
Process Revision Level: S0074.E03.002 (002) 

Description 

reaudit reformats audit copies of take headers with a new header 
structure in the text file of a specified system. 

Execution Syntax 

reaudit can be executed from SI! Command Interpreter. At the semi¬ 
colon prompt, enter reaudit followed by the desired parameters and 
[return]. For example: 

reaudit [/in (config)/] (old name), [(new name)], [(system)] 


(config)—the configuration file for the system. If the program is run from 
SII Command Interpreter, this need not be specified. If a file name is 
specified, it overrides whatever is supplied by command interpreter. 

(old name)—the structure name under which the old headers are format¬ 
ted. 

(new name)—the structure name under which the new headers are to be 
formatted. If a new structure name is not specified, the structure 
name for the header file being reformatted is assumed. 

(system)—the system whose audit copies in the text file are to be refor¬ 
matted. If a system is not specified, the text file in the system under 
which SII Command Interpreter is running will be reformatted. 

For example, if you wish to reformat a system that has just been 
updated so that the audit copies in the text file will correspond to the new 
format of the header file, you might use one of the parameter strings 
below. 

To reformat the system under which an SII terminal is running: 

reaudit old^header 

To reformat the editorial system from a Tandem Command Interpreter: 

reaudit /in Ssystem.systada.config/ old'header. . e 

To reformat all systems: 

reaudit old^header. . e 
reaudit old'header. . c 

To reformat the system before conversion: 

reaudit header, new'header 
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WARNING 

reaudit does not interlock stories as it reformats. 
The System/55 software (Szeus, Setw and so on) 
must be running for reaudit to be successful 


REAUDIT Error Messages 

The messages below may be given while you are using reaudit. Most 

messages occur immediately following the command entry that generated 

the error. 

“nn Audit copies reformatted”—This message indicates the number of 
copies reformatted during this run of reaudit. 

“Can’t find”— reaudit could not locate a record in the configuration file. 

“Can’t handle numeric arrays”—The reformat cannot be performed. 

“Can’t open [filename]”—Either the file does not exist or you do not have 
the authority to access it. 

“i/o failed to [filename]”—There has been a hardware failure, the disk drive 
is not working properly, the file is full, etc. 

“keyposition failed to"—Contact your Sll System Engineer. 

“No fields to reformat”—You may have made an error in entering the 
reaudit run parameters. Recheck your entries. 

“No system specified”—You failed to specify a system in the run parame¬ 
ters. 

“Reformatting”—This message is displayed while reaudit is processing 
stories. It is for your information only. It does not indicate an error. 

“Reformat aborted!”—Reformatting could not be completed for some rea¬ 
son. Contact your Sll System Engineer. 

“nn stories read”—The number of stories read during this run of reaudit. 
This message is for your information only. It does not indicate an 
error. 

“nn stories w/ audit copies”—The number of stories with audit copies in 
this run of reaudit. This message is for your information only. It does 
not indicate an error. 

“Structure too large”—The specified structure cannot be reformatted. 

“Too many fields”—The specified structure cannot be reformatted. 
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SECTION 85 

REQUEST 

Standard Disk File Name: SSYSTEM.SYSTEM.REQUEST 
Process Revision Level: S0076.E01.000 (007) 

Description 

request is a utility that sends parameters to SI I software. The parame¬ 
ters have a different effect depending on the process that receives them. 

For the purposes of example, typical process names are used in Table 
85.1 to refer to various process types: $zeus (super), $egod and $cgod 
(god), $dna (download), Sefio (fio), and $F504 (econtrol). The process 
names are not fixed, and may be different on your system. Some request 
functions can be performed using the qrequest utility. See Section 82. 

Execution Syntax 

REQUEST can be executed from Sll Command Interpreter. At the semico¬ 
lon prompt enter request followed by the process name and [return] , 

request will return its process number and a question mark prompt (Figure 
85.1). At the prompt, enter the desired parameters and press IreturnI . 

request again returns its process number so that you may enter more 
parameters. If you do not want to enter more parameters, press 1 ctrl||y| . 
request will then prompt for another process name. If you do not want to 
request another process, respond by pressing [ctrlI 0 (eof!). 


; request„{pr es s_.name) 

00,023; ? (param), (param), etc. 
00,023; ? (eof) 

00,023; Process; ? (eof) 


Figure 85.1. Format for Executing a request to a Process 


Table 85.1 

Process Requests 

PROCESS 

REQUEST 

RESULT 

Saopr 

i1,“$term4'’ 

Opens $term4 as console log 
device #1 

$AOPR 

il 

closes log device #1 

$AOPR 

iy, “$xxx" 

opens Sxxx as console log 
device #y (possible y values 
from 1 to 4) 
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Table 85.1 



Process Requests (continued) 

PROCESS 

REQUEST 


RESULT 

$F504 

-20 


Start the terminal $F504 is 
running. This request can be 
made to any econtrol pro¬ 
cess. 

SCFIO 

0,9 or i9 


cfio closes its files. 

$CGOD 

il 


Starts downed processes that 
are descendants of $cgod. 

$CGOD 

i12,i0,d (story #) 

Deletes given take from re¬ 
questor's queue. 

$CGOD 

il 4 


Resets stats obtained by B 
(busy). 

$CHYF 

i3 


Write current hist list in cpu to 
hit list file on disk. 

SCLIN 

iO 


Statistics request. The last ini¬ 
tialization date/time and the 
number of current records are 
displayed. 

$CLIN 

il 


Re-initialize linage totals. 

$CUN 

i2 


Update all linage records. 

$CMSG 

il 


Close files and reopen (re-ini¬ 
tialize). Used when adding 
new user or group. 

$CONF 

il 


Reconfigure Sconf 

$CONF 

i2 


Stop Sconf 

$CRCK 

iO 


Re-initialize. 

$CRCK 

i4 


Reply with statistics to re¬ 
questor. 

$CPRG 

i2 


Die gracefully 

$CRCV 

i5 


Reconfigure to take note of 
changes in system descrip¬ 
tion records, maps or text ta¬ 
bles 

$CSPL 

-1 


Load hit list into recovery file. 

$CSVE 

i22 


Die gracefully 

SCTW 

il 6 


Die nicely (in between pro¬ 
cessing of stories so stranded 
text records are not left in the 
text file. 

$CUPD 

0,20 


Close files and reset timer 

SCUPD 

i,20 


Initialize cupdateh. Note that 
when an Advertising Control 
Record is changed, you must 
perform this request function 
for each cupdateh process 
specified in the configuration 
file records (see qrequest, 
Section 82). 
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Table 85.1 



Process Requests (continued) 

PROCESS 

REQUEST 

RESULT 

SCUPD 

i22 

Die gracefully 

$DNA 

iO“$fx” 

(ETi'960 only) Sends a mes¬ 
sage to vcu $fx “vcu will be 
downloaded soon.” 

$EBRT 

il 

Close files 

$ebrt 

i2 

Die gracefully 

Segod 

il 

Starts downed processes that 
are descendants of Segod. 

$EFIO 

0,9 or i9 

efio closes its files. 

Segod 

i12,i1, (story #) 

Deletes specified take from 
requestor’s queue. 

Segod 

il 4 

Resets stats obtained by b 
( busy). 

Sehyf 

i3 

Write current hist list in cpu to 
hit list file on disk. 

Semsg 

il 

Close files and reopen (re-ini- 
tialize). Used when adding 
new user or group. 

Seprg 

i2 

Die gracefully 

Serov 

i5 

Reconfigure to take note of 
changes in system descrip¬ 
tion records, maps or text ta¬ 
bles 

Serot 

iO 

Return status to requestor 

Serot 

il, (line name) 

Update routing records by 
clearing cache (all of cache is 
cleared if no line name is sup¬ 
plied 

Serot 

i2 

Stop when pending request is 
finished 

Sespl 

-1 

Load hit list into recovery file. 

Setw 

il 6 

Die nicely (in between pro¬ 
cessing of stories so stranded 
text records are not left in the 
text file. 

Seupd 

i22 

Die gracefully 

Sevpt 

i9 

Close files 

Sevgt 

i9 

Close files 

Sevpm 

i9 

Close files 

SlNMN 

i2 

Die gracefully 

$INSV 

i2 

Stop when queue is empty 

SlNSV 

1.2 

Stop immediately 

SlNTK 

i2 

Stop at end of story 

SlNTK 

1,2 

Stop now 

SOTMN 

i2,24*0,“!” 

Stops all outtake processes 

$STAT 

iO 

Die Nicely 





85.3 






REQUEST 


Utilities 



Table 85.1 



Process Requests (continued) 

PROCESS 

REQUEST 

RESULT 

$WTAKE 

i2 

Stopped slowly 

$ZEUS 

il 

Restart all downed processes 
(subject to only, delay pa¬ 
rameters; downed systems) 

$ZEUS 

i1,“$(process name)” 

Restart this process. 

$ZEUS 

i2,“\node” 

Downs $zeus and all pro¬ 
cesses that are descendents 
of $zeus on all logical 
systems on the given physical 
system 

$ZEUS 

i2,“logical system” 

Downs all processes in the 
logical system that are de¬ 
scendants of $ZEUS. 

$ZEUS 

i3 

Show minimum vdt server 
priority (see only parameter) 

$ZEUS 

i3, n 

Set minimum vdt server pri¬ 
ority to n (see only parame¬ 
ter) 

$ZEUS 

i4 

Show vdt delay interval (see 
delay parameter) 

$ZEUS 

i4, t 

Set vdt delay interval to t 
(see delay parameter) 

$ZEUS 

i5 

Show required vdt server pri¬ 
ority (see exactly parame¬ 
ter) 

$ZEUS 

i5, n 

Set required vdt server priori¬ 
ty to n (see exactly parame¬ 
ter) 


Example 

Figure 85.2, illustrates a request to download a vcu. 


;request $dna 
01,045;? $fl 
01,045;? EOF! 

01,045;Process;? EOF! 


Figure 85.2. request to Download vcu $fi 

REQUEST Error Messages 

The following messages may be given while you are using request. 
Most messages occur immediately following the command entry that gen¬ 
erated the error. 

“Backup can’t open”—The request process cannot talk to the backup. 
“Backup cpu failed”—The backup cpu has failed. 
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“Backup running”—The backup process is running. 

“Backup process abended”—The backup process has stopped due to an 
error. 

“Backup process stopped”—The backup process has stopped due to an 
error. 

“Can’t checkopen [filename]”—There has been a hardware errorthe file 
is full,the disk drive is not working properly,etc.. 

“Can’t checkpoint to backup”—There has been a hardware error of some 
sort:the file is full,the disk drive is not working properly,etc. 

“Can’t open [filename]”—Either the file does not exist or you do not have 
the authority to access it. 

“i/o error from [filename]”—There has been a hardware failure,the disk 
drive is not working properly,the file is full,etc. 

“Illegal device”— request allows parameters to be passed only to pro¬ 
cesses. 

“Invalid input string”—There is an error in the command syntax. Recheck 
your entries on the command line. 

“Invalid parameter to command”—There is an error in the command syn¬ 
tax. Recheck your entries on the command line. 

“Invalid server process name”—You may have entered the process name 
incorrectly. Recheck your entries. 

“Must be run interactively”—The in and out files for the request process 
must be the same. 

“No backup created” —No backup for tf\p request process has been 
created. 

“No startup message found”— request did not receive the startup mes¬ 
sage it expected from the SI I Command Interpreter. Try executing 
request again. If you get this message a second time,contact your 
Sll System Engineer. 

“Primary cpu failed”—The cpu has failed for some reason. 

“Primary process abended”—The primary process has stopped due to an 
error. 

“Primary process stopped”—The primary process has stopped due to an 
error. 

“Returned from checkmonitor” —There has been a software errorthe 
primary process has failed;the backup process is failing. Try again. If 
you get this error a second time, contact your Sll System Engineer. 

“Server”—Errors have been received from the server process. 

“Unknown command”—The characters of the first word you have typed on 
the command line do not match those of a request command. 
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SECTION 86 

SCAN 

The Spooler Perusal Utility 


Standard Disk File Name: SSYSTEM.SYSTEM.SCAN 
Process Revision Level: S0079.A05.004 (005) 


The Spooling System 

The spooler configuration file describes a set of programs that allow a 
process to send output to a physical device regardless of the state of the 
device. The spooling system consists of Sspls, the spooling system su¬ 
pervisor, and $s, the spooling system collector. The relationship between 
these processes is illustrated in Figure 86.1. The spooling supervisor 
schedules jobs going out to the devices and handles the i/o to devices. If a 
device is off line, the spooler continues to collect data in the data file 
spl.data, transmitting it to the device when it becomes available at the 
rate at which the device can accept it. 



Figure 86.1 Spooling System 
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Each job that enters the spooling system has a location consisting of a 
#group and destination and written in the format #group.destination. 
The job location is the key to how the spooling supervisor will route jobs in 
the collector. When a job is output, it enters the spooling system where the 
job location is checked. If it matches the location of a device, the job is sent 
to the device (as the device becomes available). If the job location does 
not correspond to a device, the job is held in the data file (spl.data). 

The spooling system is set up using the Tandem Utility spoolcom, 
which allows locations to be mapped to devices. For example, #qume 
may indicate a qume printer, #aps may indicate an aps typesetter. 

Once the spooling system has been configured, the Sll utility scan 
allows you to monitor and control jobs. 

The System/55 spooling system serves as a buffer between vdt output 
functions (output, Icmdi jo]; proof, IcmdI (pJ) and the destination output 
device (specified in the header or at the time that cdump or paged is run). 
When a take is output to a device, it goes first to the spooling system, 
which monitors the status of ail output devices. 

If the device is unavailable because it is currently processing another job 
or is off-line, jobs that have been sent to a location in the spooler that 
points to a device are held in a queue in the spooling system until the 
device is ready. When the device becomes available, the highest priority 
story is sent from the spooling system. Thus, stories may be output or 
proofed whether or not the print device is actually ready to process them. 

Jobs that are not sent directly to the device (including compiled styls as 
well as typeset and proofed material) are held in the spooler until they are 
sent to a location or deleted. 

Job Locations 

Each job is assigned a location when it enters the spooling system. A 
location is the logical destination of a job. The job is printed on the device 
connected to the location. 

Job Numbers 

As each job enters the spooler it is given a number that you use to 
access it. This is used, for example, to send a job to another location or 
delete it. 

Report and Form Names 

For jobs that are proofed or output to a typesetting device, the report 
name is always the name of the user who initiated the output function. 
Jobs that are queued to be compiled (styls, rgen reports, and so on), list 
the user name as the report; following compilation, when the job is ready, 
the user’s Tandem account number is listed. The report name is for 
information purposes only; the system does not interpret it. 

Form names, on the other hand, are used to control output to a physical 
sub-device location. In System/55, form names are used to conserve 
typesetter film. They are defined in sub-device records for a typesetter and 
might typically be called narrow or wide (or class or edit) to represent 
specified maximum film widths. If that is the case, all jobs that do not have 
measures exceeding that specified for narrow film are assigned that form 
name by the typesetter output module; all wider jobs are assigned a name 
of wide. 
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Physical device locations are given form names with the Tandem 
spoolcom process. Any job with a form name not matching the form name 
of a physical device is blocked from output. When the form name of the 
device is changed, all jobs with that form name are sent to the device. 

For a complete description of the spooling system, please see the 
Tandem 16 Spooler Management Guide (ti 6/8094). 

Spooler PARM Word 

The parm word used by the spooler (pproc) is a series of bit flags that 
enable particular options. The parm command in spoolcom is used to 
specify the options in a single integer value that is the sum of the desired 
bit values. However, that value is overridden by the parm word in the 
Spooler Device Info record if there is a record defined for the given device. 
The spooldev structure has separate Q-field definitions for each bit. The 
various bits are described in Table 86.1. 



Table 86.1 


Bits in the Spooler PARM Word 

FIELD NAME 

BIT VALUE 

MEANING 

ASCII 

i 

ascii device—Convert non-ASCii charac¬ 
ters to asterisks. Strip trailing blanks (hex 
20) 

EBCDIC 

2 

ebcdic device—Strip trailing blanks (hex 
40) 

CONTROLS 

4 

Interpret control operations (set for 
slow printers, Qume/Diablo, TI81 o, etc.) 

VERSATEC 

8 

Device is a Versatec printer (eject paper 
if no more jobs left) 

IRI 

16 

Device is an iri 

MANUAL>EEDER 

32 

Qume/Diablo: Wait for break after every 
page (manual sheet feeder) 

automatic a feeder 

64 

Diablo 630 only: Automatic sheet feeder 
is installed 

BISYNC 

128 

Device is a bisync line (data is pre- 
ceeded by an stx and followed by an 
etb). This bit is forced on by the program 
if the device is a point-to-point line (type 

7, subtype 0). 

TRANSPARENT 

256 

If bisync: Send transparent data (pre¬ 
cede buffer with dle-stx) 

IBM*6670 

512 

If bisync: Device is an ibm 6670 (append 
new line if needed; send sep commands) 

FREE^TOF 

1024 

All jobs sent to the device should start 
with a top-of-form operation. This bit af¬ 
fects only those spooler jobs that do not 
already have an initial tof command in¬ 
serted by the process that created the 
job. This bit is ignored if the header op¬ 
tion of the spoolcom dev command is in 
effect. 
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Table 86.2 lists some commonly used parm values. 



Table 86.2 


Commonly Used PARM Values 

PARM Value 

Usage 

i 

ascii line printer 

5 

ascii character printers (in order to simulate control opera¬ 
tions) 

9 

ascii printer (Versatec) 

16 

Phototypesetters connected via an iri 

4 

Qume/'Diablo printer: continuous paper roll 

36 

Qume/Diablo printer: manual sheet feeder 

68 

Diablo 630 printer: automatic sheet feeder 

1029 

Okidata 


SCAN 

scan is an interactive utility process for examining jobs in the spooling 
system before they are sent to an output device. It allows proofreading 
(without inspecting printouts), correcting, and combining, thus saving pa¬ 
per (or film), printer ribbons, and wear and tear on printers. 

scan allows you to perform any of the following functions on jobs that 
have been sent to the spooling system: 

• Release a job to its default device 

• Release a job to to a different device 

• Give a job a new priority to put it ahead of less important jobs or behind 
more important jobs 

• Change the number of copies to be produced 

• Search for errors 

• Examine a compiler listing before making a decision to print or proof it 

• Monitor job status change 

• Alter a job’s location 


Execution Syntax 

If you have the authority, you may start scan from Sll Command Inter¬ 
preter. Press IcmdI Q. At the semicolon prompt enter scan and press 
Ireturni . Or, when the semicolon prompt is displayed, enter / and press 
IreturnI . When the menu is displayed, position the cursor at the entry for 
scan and press IcmdIsi . 

If you do not have Sll Command Interpreter Authority, press IcmdI Q. 
When the menu is displayed, position the cursor at the entry for scan and 
press IcmdI [si. 

When the scan hyphen prompt is displayed, enter the desired com¬ 
mand^) and press [return! . Note that unique abbreviations of commands 
are allowed. And, more than one command may be specified in a single 
line if the commands are separated by semicolons. For example j 123;loc 
#apsi to select job number 123 and send it to apsi . 


86.4 



















Utilities 


SCAN 


All of the available scan commands are listed in alphabetical order in 
Table 86.3. A brief description of each is also provided. 


Table 86.3 
SCAN Commands 


COMMAND 

description 

AFTER ON/OFF 

Change hold-after status of job 

ALL 

Clear the job location mask 

copies count 

Change number of copies to print 

DELETE 

Delete current job from spooler 

device [name] 

Get device information 

exit (or EOF!) 

Terminate execution of process 

fall [string] 

Search for all occurrences of string 

FC 

Interactively edit last command 

find [string] 

Search for the specified string 

form form name 

Change form name of job 

group option 

Apply option to set of jobs 

help [command] 

Print long command descriptions 

hold on/off 

Change hold status of job 

idetail [job] 

Display/set current job (detailed) 

info [job] 

Display/set current job 

jdetail [number] 

List or select jobs (detailed) 

jform [number] 

List or select jobs (form name) 

job [number] 

List or select jobs 

jreport [number] 

List or select jobs (report name) 

lhex [/out/ - ] range 

List contents of current job in hex 

list [/out/] range 

List contents of the current job 

location group.dest 

Change location of job 

numcol [width] 

Display or set width 

only [mask] 

Display [or set] the location mask 

open (supervisor) 

Open a new supervisor process 

poctal [/out/] range 

List current job in octal 

priority pri 

Change priority of job 

report report name 

Change report name of job 

select option 

Select a complete mask 

startcol [column] 

Display or set starting column 

wait [job] 

Wait for the job to change state 

xs range 

Begin tal program cross-reference 

xf [/out/] 

Print tal program cross-reference 


The Help Command 

The scan help command lists the available commands and a brief 
description of each. To use it, start the process and enter help at the 
hyphen prompt. To display a more detailed description of a specific com¬ 
mand, enter help followed by the name of the command. 

Exiting SCAN 

You can exit scan at any time by entering 1ctrl| fvl. The process will log 
the message eof! and exit. You can also stop the process by entering exit 
or e in response to the scan hyphen prompt. 
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Listing and Selecting Jobs 

The job command has two functions: 

1. To list all jobs within the currently defined mask (see “Setting the 
Job Selection Mask”) that have job number in the range specified, 
and 

2. To select a job to act on with other scan commands. 

Listing Jobs 

To list all jobs to which your Tandem user and access levels allow you 
access, enter job or j at the hyphen prompt. (The super.super user can 
access all jobs with this command.) 


-job 

Job 

State 

Pages 

Cop 

Pri 

Group 

Dest 

Report 

7 

Hold 

34 

1 

4 

#DEFAULT 


SII SUPER 

8 

Print 

23 

1 

6 

#QUME 

DEFAULT 

SHARON 

12 

Ready 

19 

1 

4 

#TCU 

TANIO 

SII SUPER 

22 

Open 


1 

4 

#APS 

MAIN 

SII SUPER 


Figure 86.2. scan Job Status Report 


Jobs are listed by number. The number of pages in each job, the 
number of copies requested, the priority, group, destination, and current 
state of the job are also listed. 

Together the group and destination are known as the job location (see 
“Job Locations” above). 

The group name is always preceded by #. For example, the location 
names in Figure 86.2 are: #default, #qume.default, #tcu.tanio, and 
#aps.main. #aps is the group name while #aps.main is the name of a 
specific aps. 

Listing a Range of Jobs 

You may specify that a range of jobs (selected by number) is to be 
listed. To do so, enter the lowest job number you want to list, and the 
highest job number you want to list, separated by a slash (/). 

j 5/52 

This instruction lists jobs 5 through 52 in the currently defined mask 

j/52 

This instruction lists current job through 52 in the currently defined mask. 
(The current job is the last job selected, see “Setting the Job Selection 
Mask.”) 

When a range of jobs has been listed, the high and low job numbers 
remain part of the mask. The command job* or j* clears them. 

35/ 

This instruction lists jobs 5 through current in the currently defined mask 

j 5/1 

This instruction lists jobs 5 through last in the currently defined mask 

With this command you may also specify job numbers relative to the 
number of the currently selected job. Use a minus sign (-) to specify job 
numbers lower than the currently selected job; use a plus sign (+) to 
specify job numbers higher than the currently selected job. 
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j 5/-1 , 

This instruction lists jobs 5 through current - 1 in the currently defined 
mask. 


j-5/ + i 


This instruction lists jobs current - 5 through 
defined mask. 


current + 1 in the currently 


List Jobs with Form Names 

The jform command causes all subsequent job status lists to include 
the form name of the job rather than report name. If a job number is 
supplied, jform makes that job the current job. If no job number is given, 
the current job is not changed. In either case, the status of the current job 
is displayed (see “Report and Form Names”). 

List Jobs with Report Names 

The jreport command causes all subsequent job status lists to include 
the report name of the job instead of the form name (see “Report and Form 
Names”). If a job number is supplied, jform makes that job the current 
job. If no job number is given, the current job is not changed. In either 
case, the status of the current job is displayed. 


Selecting a Job 

To select a job as the current job, in order to change its location or to 
delete it for example, enter the job command at the hyphen prompt fol¬ 
lowed by the job number. 


-jobs 

This instruction selects job number 5 

Detailed List of Jobs 


If no job number is given, the jdetail command displays a detailed list 
of all jobs currently in the spooling system. 

If a job number is specified, that job is selected as the current job. 


Detailed Information about a Job 

The idetail command displays a detailed description of the specified 
job (Figure 86.3) and selects that job as the current job. 


-idetail 

Job 

390 

State 

Pages Cop Pri Group Dest 

Report 

390 

Hold 

43 1 4 #Default 

SHARON 

Collected by $S 

from 4/05/82 16:38:21 to 4/05/82 

16:43:05 

Owned by 

254,255, Hold after 



Figure 86.3. Detailed Information for Job 390 


Setting the Job Selection Mask 

Generally, you will probably not be interested in listing all the jobs in the 
spooler. The only and select commands allow you to specify a mask to 
narrow the listing of jobs to fit your needs. With these commands you may 
vie.v a listing of jobs that have been sent to a specific device, that have a 
specified priority, are a specified number of pages in length, or are in a 
specified state (open, for example). 
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This feature is especially useful when used with the Input Spooling 
System, where there may be thousands of jobs in the spooler. 

The Job Location Mask 

When entered with no parameters, the only command displays the 
current job location mask. If a parameter is given, the location mask is set 
to that parameter. 

The location mask is used by the job and wait commands to select a 
subset of the job list for display purposes. Only those jobs whose location 
group matches the location mask will be displayed. 

Note that the only command has the same effect as the select loca¬ 
tion command described below. 

The SELECT Command 

The select command allows you to filter out jobs in which you are not 
interested and determines on which jobs the list, group, and wait com¬ 
mands will operate. 

Jobs may be selected on the basis of owner, state, location, form, 
report, collector, pages, date, priority, and job number. 

To define a job selection mask, enter the select command followed by 
a list of selection parameters, separated by commas. The following selec¬ 
tion parameters are allowed: jobs, state, location, priority, owner, 
form, report, collector, pages, and date. Each is explained in detail 
below. 

If you enter the select command without a list of selection parameters, 
the currently selected mask is displayed. 

Omitted selection parameters are not considered in the selection of 
jobs. Only one occurrence of each selection parameter is allowed in a 
single select command. 

With the exception of form (see “form" below), if a selection parameter 
is used without a parameter string, that part of the mask will be “unselect¬ 
ed” and will not be used to filter. 

Each selection parameter changes one part of the mask and has its own 
parameter string format, as explained following the examples below. 

-select jobs 57/L, state ready, pages <150 

Only jobs with job numbers greater than 57, in the ready state, that have 
less than 150 pages will be in the subset. 

-select jobs, priority <5, owner 254,255 

Clears the jobs part of the mask. Only jobs with priority less than 5, owned 
by Tandem user 254,255 will be in the subset. 

-select date through 5/9/84 

Only jobs closed through 5/9/84 are included. 

-select date from 5/9/84 8:23:00, date through today 

Only jobs closed between 5/9/84 at 8:23 and today will be in the subset. 

-select date, owner * 

Clears the date part of the mask. Allows you to see jobs owned by any 
Tandem user; however, Tandem security still prevents you from acting, 
with the group or wait commands, on jobs owned by other Tandem 
users. 
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JOBS 

The jobs selection parameter restricts the group to those jobs with job 
numbers greater than or equal to the low job and less than or equal to the 
high job in a relative job iisting. 

The low job is specified under the following criteria: 

1. If no job number is specified for the low job it is assumed to be the 
current job. For example: 


-j/29 

lists jobs current through 29 

2. If the job selection parameter starts with a plus or minus sign the low job 
will be relative to the current job by the parameter value. For example: 

-j-7/29 

lists jobs current minus 7 through 29 

3. Otherwise, the low job will equal the parameter value. 

The high job is specified in a similar fashion, except that if the parameter 
is l the high job will be the last job in the spooler. 

Commands that select a low job greater than the high job are rejected. 


STATE 

The state selection parameter allows you to select jobs that are in a 
specified state in the spooler: ready, print, hold, or open. 

-select state ready 

selects only those jobs in the ready state. 


LOCATION 


When entered with no parameters, select location clears the current 
job location mask (if one has been defined). If a parameter is given, 
select location sets the location mask to that parameter. 


The location mask is used by the job and wait commands to select a 
subset of the job list for display purposes. Only those jobs whose location 
group matches the location mask will be displayed. 

-select location #aps.news 

selects only those jobs that have been output to group name aps. destina¬ 
tion name news. 


PRIORITY 

The priority selection parameter allows you to select stories based on 
their priority. If greater than (>) or less than (<) is specified, only those 
jobs with a priority greater than or less than the specified amount will be 
selected. Otherwise, only those jobs with a priority equal to the amount will 
be selected. 


-select priority = 5 

selects only those jobs with priority equal to 5. 


-select priority < 5 

selects only those jobs with priority less than 5 


-select priority > 

selects only those jobs 


O 

with priority greater than 


5 
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OWNER 

The owner selection parameter allows you to select jobs based on the 
Tandem user. 

The parameter owner * lists jobs with a different Tandem security level 
than the current user, but the jobs are not selectable for the group or wait 
commands. This ability is not cleared with an all command, but is cleared 
with a select command used without a parameter. If the parameter speci¬ 
fies a Tandem security user and group, then only those jobs that are 
owned by that user and group will be included. 

-select owner 254,255 

selects only those jobs owned by Tandem user 254,255. 

-select owner * 

Jobs owned by any user will be displayed with a job command. However, 
the jobs owned by other Tandem users cannot be selected or processed in 
a group or wait command unless the user is a member of the super 
group. This ability is not cleared by the all command (see “Clearing the 
Job Selection Mask” below) but is cleared the next time select owner is 
executed without a parameter. 

FORM 

• 

The form selection parameter allows you to select jobs based on the 
form name. Only those jobs whose form name matches the form name 
specified will be included in the group. If form is entered without specify¬ 
ing a form name, only those jobs with a blank form name are selected. 

-select form class 

selects only those jobs with the form name “class.” 

REPORT 

The report selection parameter allows you to select jobs based on the 
report name. Only those jobs whose report name matches the report name 
you have specified will be included in the group. 

-select report ralph 

selects only those jobs with the report name “raiph.” 

COLLECTOR 

The collector selection parameter allows you to select jobs based on 
the collector name. Only those jobs whose collector name matches the 
collector name specified will be included in the group. 

-select collector $s 

selects only those jobs collected by “$s.” 

PAGES 

The pages selection parameter allows you to select jobs based on their 
length in pages. If greater than (>) or less than (<) is specified, only those 
jobs with more or fewer pages will be selected. 

-select pages <5 

selects only those jobs with fewer than 5 pages 

-select pages >5 

selects only those jobs with more than 5 pages 
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DATE 

The date selection parameter allows you to specify a range of dates 
and times in the following format: 

-select date from day/time through day/time 

The day can be expressed numerically 4/14/84, or as today, or yester¬ 
day. If a day is not specified, but a time is, the date command defaults to 
today. Only those jobs closed after the from date and before the through 
date are selected. Jobs that are open when the select date command is 
executed will not be selected if a through date has been specified. 

Time is specified in hours, minutes and seconds of the 24 hour clock. 
The seconds may be omitted if desired. For example, 4:15 will be inter¬ 
preted to mean a quarter after four and not 4 minutes and 15 seconds after 
midnight. 

-select date from 4/5/84 

selects the “from” part of the mask, leaves the “through” part alone. 

-select date through 4/5/84 

selects the ‘Through” part of the mask, leaves the “from” part alone. 

-select date from 

clears the “from” part of the mask, leaves the “through” part alone. 

-select date through 

clears the “through” part of the mask, leaves the “from” part alone. 

-select date 

clears both from and through parts of the mask. 

Clearing the Job Selection Mask 

all clears the job selection mask (see “only” and “select”) so that all 
jobs in the spooler are listed when the job command is executed. 

WAIT 

The wait selection parameter allows you to specify that scan is to wait 
for any job, or a particular job, to change state before displaying a list of 
jobs. The command syntax is: 

-wait job number,state 

You may specify any of the possible job states: hold, open, ready, or 
printing. 

If no parameter string is specified, scan waits for any job in the currently 
defined mask to change. If a job number is specified, but the state option 
is not invoked, scan waits until the particular job changes. If the state 
option is used, scan waits until the specified job reaches the specified 
state. It the job is already in the specified state, the command completes 
immediately. 

-wait 2,ready 

waits for job 2 to go to the ready state and would complete if job 2 is 
already in the ready state 

-wait 2,print 

waits for job 2 to go to the print state and would not complete when job 2 
changes from open to ready. 
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Searching 

The find command allows you to search forward in the job from the 
current line looking for occurrences of the specified string. If no string is 
specified, the last string, if any, is reused. The search begins on the next 
line, using the same number of previous lines to display as in the last find 
command. The search terminates when the end of the job is reached, a 
match is found, or the Icmdi key is pressed. 

If a match is found, the matching line is printed on the terminal. 

To find all occurrences of the search string specify find*. 

To list the 1-5 lines preceding the search string, enter find-n (where n is 
a number from 1 to 5). Blank lines are suppressed. 

-f-5 abc 

lists the line in which the string “abc” is found and the 5 lines preceding it. 

Specifying the Search String 

The search string can be enclosed in quotes (both double and single 
quotes are allowed). This allows searching for: 

1. leading and trailing blanks 

2. semicolons 

3. right parenthesis (used in complex group commands) 

4. quotation marks—Double quotes (“) can be searched for by using 
single quotes (') as a delimiter. Single quotes can be searched for 
by using double quotes for the delimiter. 

5. search strings whose first character is a minus sign (-) when the 
previous page option has not been utilized 

Quotation marks are also used when specifying a range of pages (see 
below). 

The search string must be placed within quotes if the first character 
searched for is a or a and the corresponding option has not been 
invoked. 

A start and stop page number may be specified to limit the search to a 
range of pages. Page numbers may be specified in the same format as the 
list command. For example, find “string” * would search from current 
page. If no stop page is specified, the search will continue through the last 
page or until the string is found. 

The search string must be enclosed in quotes to use this option (making 
it impossible to search for quotes). 

-f abc 

lists the line that the string abc is found on. 

-f 

searches for the next occurrence of the string found, from the location at 
which it was last found. 

-f ' ’ ’ A * ■ * 

finds the quoted a 

f-5 ’'a;b‘* 23 

lists the 5 lines before and the line the string a;b is found on, starting on 
page 23. 
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Finding Ail Occurrences of a Search String 

The fall command (find all) is identical to the find command, except 
that the search does not terminate when the string is found. Instead, all 
occurrences of the specified string are listed. The page number is dis¬ 
played whenever it changes. If the find lists previous lines, duplicate lines 
will not be displayed. 

Job Hold Status 

The hold command changes the hold status of the current job. Can be 
used only whiie a job is selected. See also “Differences Between hold and 
after” later in this section. 

Hold-After 

The after command changes the hold-after status of the current job. 
You must indicate on or off. This command can be used only while a job 
is selected (see “job,” and “Differences Between hold and after”). 

Differences Between HOLD and AFTER 

When a job is placed on hold with the hold on command, it may not be 
sent to the printing (or typesetting) device with the location command. A 
job is released from hold with the hold off command. 

The hold-after flag is turned on with the after on command. This 
means that the job will be put on hold following printing (or typesetting). 
This flag is in effect until turned off with the after off command; then the 
job will leave the spooling file the next time the location command is used 
on it, or when it is deleted. 

A job on hold may be released for printing with the hold off command. 
The job is taken off hold (made “Ready”). If the after flag is on, the job is 
placed back on hold following printing. 

The after on flag is therefore useful for jobs like the classified dump 
(cdump) that take a long time to process. If there is a failure at the 
typesetter or the film processor, the job can be sent to the device again 
after the problem has been fixed. Once satisfactory output has been 
achieved, the job may be deleted with the delete command. 

Specifying the Number of Copies for a Job 

The copies command allows you to specify the number of copies that 
are to be made of the currently selected job. Can be used only while a job 
is selected. 

Changing Job Priority 

The priority command changes the spooling priority of the current job. 
This command can only be used while a job is selected. 

-j 123 
-priority 4 

selects job 123 and changes the priority to 4 

Changing the Location of a Job 

The location command changes the location of the current job and 
sends the job to that location. If no change to the location is specified, the 
job is sent to its default location. This command can only be used while a 
job is selected. 
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Changing the Report Name of a Job 

The report command changes the report name of the current job. This 
command can only be used while a job is selected. 

-j 123 

-report chris 

Changes the report name of job 123 to “chris” 

Changing the Form Name of a Job 

The form command changes the form name of the current job. Can be 
used only while a job is selected. 

-j 123 

-form narrow 

changes the form name of job 123 to narrow 

Listing the Contents of a Job 

The list command with no parameters displays the current page num¬ 
ber. When parameters are supplied, list displays the contents of the 
currently selected job. 

Jobs that have been justified and output to typesetters (aps, L 606 and 
so on) should not be displayed on the terminal with the list command. 
These jobs contain character codes and commands for the typesetter that 
cannot be converted for display—and can cause vdt malfunction. 

An optional output file specification may be included to send the output 
to a location other than the terminal. See “Listing a Job to an Alternate 
Output File.” 

The Job Display Width 

Each job in the spooler has a given line length. When a job is displayed 
with the list command it begins at startcol and ends at numcol (see 
“Changing the Display Column Width” and “Changing the Starting Column 
Number”). If the lines of the job exceed the screen width and are longer 
than numcol they are truncated, not wrapped. If the lines of the job 
exceed the line length but are shorter than numcol, they are wrapped. 

Changing the Starting Column Number 

When the startcol command is executed without parameters, scan 
lists the current starting column number. If a value is given, the starting 
column number is changed to that value. This command has the effect of 
moving all display lines to the left, beginning the display in the specified 
column (for example, to display the second half of a report). 

-startcol 

lists the current starting column 

-started 10 

changes the starting column to 10 

Changing the Display Column Width 

When the numcol command is executed without parameters, the cur¬ 
rent width value is displayed. If a value is supplied, scan changes the 
display column width to the specified value. When not specified, lines are 
truncated at the last display column of the vdt. 
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Up to 900 bytes (spooler maximum) can be displayed with the numcol 
command. This is a necessary step when copying jobs from one spooler to 
another under the Input Spooling System. 

Specifying a Range of Pages for Listing 

The range specification consists of one or two page specifications sepa¬ 
rated by a slash. This figure indicates the range of pages to be listed. For 
example entering “list 2/6” will display pages 2 through 6 of the current job. 

If only one page specification is given, only that page is listed. For exam¬ 
ple, “list 9” will list only page 9. 

A page specification may be absolute (list 9), or relative. A relative 
page specification may be relative to the current page, indicated by an 
asterisk, or relative to the last page, indicated by the letter l; list l lists the 
last page of the job. For example, list *-i/*-m lists the page preceding 
the current page, the current page, and the page following the current 
page. If the current page is 6, list *-i/* +1 lists pages 5, 6, and 7. list t/l 
will the list the current job beginning with the first page and ending with the 
last. 

The range will specify a first line to list and a last line to list. For instance: 

-13. 5 

lists the fifth line on the third page 

-13.15/3.17 

lists lines 15-17 on the third page 

-lh4.l 

lists the last line on the fourth page in hex 

-po3.9/L.5 

lists every line between the ninth line on page three and the fifth line on the 
last page in octal. 

-li. l 

lists the last line on the last page 

LHEX 

The lhex command is identical to the list command, except a hexadec¬ 
imal representation of the data is displayed along with the ascii. This 
command can be used only while a job is selected. 

Pressing Icmdi while listing in hexadecimal returns you to the hyphen 
prompt. 

POCTAL 

The poctal command is identical to the list command, except that an 
octal representation of the data is displayed along with the ascii, control 
and setmode messages embedded in the job are shown. 

Pressing IcmdI while listing in octal returns you to the hyphen prompt. 

Listing a Job to an Alternate Output File 

The following commands are used in scan to copy a job from one 
spooler to another. The same steps are followed to list a job to a file other 
than the terminal. Note that you must suppress the initial page eject (s 
/file'name/) and set numcol to 900 when copying jobs from one spooler to 
another under the Input Spooling System. 
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;scan $ispl 

scan the specified spooler 

-numcol 900 

set the display width to maximum (you must do this when copying jobs 
from one spooler to another) 

-job 123 

select the job number 

-list s /\sii. $ib. #temp/ l/l 

suppress initial page eject, list the entire job to the specified file 

You may also specify that the job is to be listed in hexadecimal (lhex) or 
octal (POCTAL). 

Deleting Jobs from the Spooler 

The delete command deletes the currently selected job from the spool¬ 
ing system. Can be used only while a job is selected. 

-j 123 
-delete 

deletes job 123 from the spooler 

GROUP 

The group command allows the user to apply a scan command to the 
group of jobs defined by the current job location mask. A mask must have 
been previously specified with the only or select commands. The syntax 
of the group command is listed below: 

GROUP (command) (parameter) 

The following operations can be performed on a selected group: find, 

LIST, LHEX, POCTAL, INFO, IDETAIL, DELETE, COPIES, PRIORITY, HOLD, AFTER, 

location, report, and form. Any series of legal commands for a job can 
be executed for all members of a group by placing the commands within a 
matched pair of parentheses, separated by semicolons. 

g (id;f 'str); 1 ;11) 

prints a detailed description, finds the string str);, and lists the last page 
for every member in the group. 

If you press |cmd| while processing group commands, scan aborts the 
rest of the command and returns to the hyphen prompt. 

The current job is restored at the end of the group command. 

-group copies 2 

change the number of copies for the group to 2 

-group delete 

delete the group from the spooling system 

-group hold off 

take the group off hold 

-group location qume.sii 

change the location of the group to qume.sii 

-group priority 6 

change the priority of the group to 6 

-group report chris 

change the report name of the group to chris 

-group form wide 

change the form name of the group to wide 
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For more information about the commands used with the group com¬ 
mand, see the description for that particular command. 

Device Status Lists 

When entered without parameters, the device command lists all devices 
controlled by the spooling system (Figure 86.4). 


-device 

Device 

State 

Proc 

$A4. #T15 

Off Line 

SSPLP 

$EXOR 

Waiting 

SSPLP 

$J 

Waiting 

SJOBS 

SAPS1 

Waiting 

$SPLP 

SAPS2 

Busy 

SSPLP 

$APS3 

Off Line 

SSPLP 

$LP 

Waiting 

SSPLP 

$PUNCH 

Waiting 

SSPLP 

SQUMEl 

Busy 

SSPLP 

$QUME2 

Waiting 

SSPLP 

$RP 

Waiting 

SRPRT 


Figure 86.4. scan Device Status List of ail Devices 

If a specific device name is entered, device reports the device status 
followed by a list of jobs waiting to be sent to the device (Figure 86.5). 


-device Squmel 

Device 


State 

Proc 

$QUMEI 


Busy 

SSPLP 

Job Group Dest 

Pages 

Wait 

Report 

246 #QUME DEFAULT 

3 

00:00:28 
- v- 

PEGGY 


Figure 86.5. scan Device Status Report for Device qumei 


Special Application Commands 

The xs and xf commands are usT-type commands with special applica¬ 
tions for tal complier listings. They should be used only by qualified 
programming personnel. 

XS 

The xs command is similar in syntax to the list command. However, 
instead of listing the selected pages from the current job, xs searches 
them to locate references to identifiers. The references are placed in a sort 
file for creation of a cross-reference listing. Only tal compiler listings may 
be used. 

The xs command takes a range specification but not an output file 
specification (see xf below). 

XF 

The xf command completes a cross-reference listing and should be 
given after one or more xs commands, which may be for the same or 
many listings (up to 50). This command requires an output file specification 
in the same form as the list command, but it does not take a range 
specification. 

The xf command may be aborted after the sort is complete by pressing 
the IcmdI key twice. 
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SCHEDSET Version 01 (001) 

schedset (Process Scheduling) has two applications: (1) Allowing users without 
command interpreter authority to execute specific utility programs from menus of 
programs and/or groups of programs; (2) Scheduling programs to run automatical¬ 
ly on specified days and/or at specified times. For more information, see Section 8 
of the System Manager’s Manual. 


1. RENAME command now lets users rename a program 

Background: 

Several clients have requested a program rename function. 

Solution: 

We have added the rename command and logic. To rename a program, simply 
use: 

/rename (oldname), (newname) 

(where ' is the SCHEDSET prompt). 

Note: The rename command does not rename group or user names. 
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SECTION 87 

SCHEDSET 

Standard Disk File Name: SSYSTEM.SYSTEM.SCHEDSET 
Process Revision Level: S0080.E01.001 (000) 

Description 

Program schedset has two applications: 

1. Scheduling Programs for Use—allows users without Command In¬ 
terpreter authority to execute specific utility programs from menus of 
programs (processes) and/or groups of programs; and 

2. Scheduling Programs for Execution—scheduling programs to run 
automatically on specified days and/or at specified times. 

If defined for a user with program schedset, an alphabetic me nu of 
programs and/or program groups is available when he or she enters [cmdJ 
Q. If the user has Sll Command Interpreter authority, he or she should 
enter / (followed by [return]) in response to the Sll Command Interpreter 
prompt. We refer to this as a Process List (Figure 87.1), a process being a 
running program (a program becomes a process when the user or another 
process starts it). Both program groups and individual program names 
may be in the list. 


Process list for 

SHIRLEY 

XV£ 

Name 

Description 

Grp 

PRODUCTION 

Production utility programs 

Pro 

BUSY 

List busy items by system 

Pro 

FIXCHAR 

SII character library maintenance program 

Pro 

SCAN 

Spooling file perusal program 


Figure 87.1 A User's Process List 


In this case one group and three individual programs are listed. To list 
the programs in the group production, the user points at that item and 
executes [cmdI [71. A similar list, entitled “Processes in group (appropriate 
name),” is displayed (Figure 87.2) from which the user may select a 
program to be executed by pointing the cursor at it and entering ]cmdJ [s] 
(start process). 


Processes 

in group PRODUCTION 

Typ 

Name 

Description 

Pro 

CDUMP 

Perform classified dump 

Pro 

FGEN 

Form generation program 

Pro 

LGEN 

List generation program 

Pro 

RGEN 

Report generation program 

Pro 

SCAN 

Spooling file perusal program 


Figure 87.2. A Group Process List 
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A user can only display those groups and processes to which he or she 
has been given explicit scHEDSET-defined access; similarly, a user can 
only run those programs he or she can display. 

In order for a a user to successfully start a process (open all appropriate 
files) that user must be able, by virtue of his Tandem user account, to 
execute it through Command Interpreter were he to have that authority. 

The process list is an important means of granting users the ability to 
run utilities that are otherwise out of their reach without Command Inter¬ 
preter authority. It permits the grouping of programs by user application 
and is a convenience to those users with Command Interpreter authority 
who would be able to execute all of the named programs anyway. 

Execution Syntax 

As stated at the beginning of this section, the program schedset is 
used both for the definition of menus of processes for individual users and 
for the scheduling of programs to run automatically. Figure 87.3 displays 
the menu of schedset commands. 

This program uses the virgule (/ —diagonal slash) as a prompt char¬ 
acter. Most commands apply to both functions of the program. The follow¬ 
ing are exceptions: 

1 . the user and group commands apply only to user menus, and 

2. the schedule command applies only to program scheduling. 


/h 

FC 

HELP [(command)] 

EXIT (or EOF!) 
PROGRAM (name) 

DELETE (type) (name) 
LIST [type] [DETAlT] 
USER (name) 

GROUP (name) 

SCHEDULE (name) 

/ 


Figure 87.3. Program schedset Help Menu of Commands 

The help command supplies more detailed help for each command. At 
the semicolon prompt enter help or h followed by the name of the com¬ 
mand. The shortest unique abbreviation of a command may be used. In 
the case of this particular program, no two commands begin with the same 
letter, so a single letter suffices as an abbreviation: l for list, s for sched¬ 
ule. This simplifies input of the commands. Each command is dealt with 
separately below. 

EXIT Command 

The command. exit (or e) may be used to exit schedset and most other 
interactive programs. However, the easiest method of exiting is by entering 
IctrlI [T[ (eof). This command is also common to most programs. 


Interactively edit last command 
Print long command descriptions 
Terminate execution of program 
Define the named program 
Delete the specified entry 
list all items [of the spec'd type] 
Define access of a user 
Define a group of programs 
Schedule the named program 
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PROGRAM Command 

Before a program may be scheduled or added to a menu or a group, it 
must first be defined with the program command. Enter the command as 
follows: 

/p name 

where name is the name of up to 12 alpha and/or numeric characters (no 
special characters) that you wish to use in referencing the program in a 
users process list. 

The name need not be the same as the program’s formal file name. 
Some programs like b (busy) have several useful functions (as specified in 
the startup message) and each version may be named for its function; e.g., 
b, users, summary. The name should be meaningful to users. If lgen is 
not descriptive enough, in users’ lists it may be called listdesign. 

When a program name is entered for the first time, you will be asked to 
supply various details about it. Most of the requested information applies 
only to scheduled programs (as indicated below). For all other programs, 
at least the “Program file name” must be given. You will be prompted as 
follows: 

Program description: 

Enter an optional description of up to 44 characters. The description is 
used in users’ process lists and in the list command of this program. 

Program file name: 

Enter the file name of the program: 

$(volume name), (subvolume name), (disk file name) 

Network nodes are not supported; only local file names are permitted. The 
program does not check the validity of the file name. 

Important: It is up to you to make certain that it is legitimate. If it is not, an 
error will result when a user (or the scheduling monitor, if it is scheduled) 
attempts to start it. 

Note: If you enter |ctrl[ 0 (eof) without answering this prompt, the new 
program name will not be saved. Entering |ctrl| (7] as a response 
to any subsequent prompt will save any information entered or 
changed so far and will return the / prompt so you may enter a new 
command. You are invited to use this function to avoid further 
prompting. 

Should VCONTROL wait after process has stopped? 

Enter y for yes, n or |return| for no. This applies to program b (busy) and 
other programs that list information on the vdt. (This application is dis¬ 
cussed later under the heading 'Running Programs Non-interactively.”) 
Responding “yes" to this question gives the user the opportunity to view 
the list produced by the program. The program is exited and the screen is 
cleared only when the user presses the |cmd| key. 

Startup message 4 * 

A message—normally a command, or a command string—given the pro¬ 
gram at the time the process is created, to be used by the process as it 
sees fit. For example, the scheduled process refresh (required on all 
systems) is really an execution of the program pup (Peripheral Utility 
Program) with the command (startup message) “refresh,” this being only 
one of the many functions of that utility program. 
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Process name: 

Applies only to scheduled programs, and should be used (allows tracking 
of program execution and error messages). The name must be unique. 

CPU? 

Applies only to scheduled programs. It is normally not necessary, but you 
may specify the number of the cpu in which the process is to run. 

Priority? 

Applies only to scheduled programs. This priority is ignored for user-start¬ 
ed processes. Process refresh runs at priority 198. For all other sched¬ 
uled programs, please consult your Sll System Engineer for his or her 
recommendation. These recommendations should be followed; using 
higher values may affect system response times. 

Default volume? 

Applies only to scheduled programs. The default volume to use when the 
process is created. For scheduled programs, this is the equivalent of the 
Command Interpreter default volume. 

Input file? 

Applies only to scheduled programs. The source of input commands/data, 
if any. An appropriate file is Sconsole (console typer). 

Output file? 

Applies only to scheduled programs. Where messages, prompts, listings, 
etc., should be printed. Depends on program. An appropriate file is Ss 
(spooler collector). 

TANDEM user name: 

Applies only to scheduled programs. Scheduled processes created by the 
scheduling monitor are treated as though they were system users. In some 
cases they may have to execute as a specific Tandem user in order to 
have access to the program file and the data files it opens. If a name is 
given you will have to supply the password: 

Password? 


At the end of this series of prompts you are asked: 

Schedule program NAME? 

Enter y for yes, n or IreturnI for no. If you answer yes, prompting will 
continue, beginning with “Which days?," as described for the Schedule 
command. (You may choose to define a program with specifications that 
qualify it for scheduling, but [by not answering “yes”] not schedule it at this 
time.) 

In summary, here are the prompts given by the Program command: 

Program description: 

Program file name: 

Should VCONTROL wait after process has stopped? 

Startup message 0 
Process name: 

CPU? 

Priority 0 
Default volume 9 
Input file? 
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Output file? 
TANDEM user name: 
(Password?) 
Schedule program 


9 


When a program name that already exists is entered with the Program 
command, a summary of the existing data for that program is listed (pro¬ 
gram refresh is used as an example): 

Program: REFRESH 

Description: Write system information to disk 

$SYSTEM. SYSTEM.PUP /IN SOSP, OUT $OSP, PRI 198, NAME SPUP/* 

Startup message: refresh 

Default volume is $SYSTEM.SYSTEM 

No ASSIGN message(s) and no PARAM message(s) . t 

VCONTROL doesn’t wait after program stops. 

Executes as TANDEM user NULL.NULL 
RETURN leaves a field unchanged^ 


* This line reports the file name, input file, output file, cpu (not specified 
here), priority and process name. 

f This data applies only to the assignments and parameters for use by a 
scheduled cobol program. It must be specified with the Tandem Com¬ 
mand Interpreter (comint). If you wish to schedule cobol programs 
written by your programming staff, please consult your Sll System Engi¬ 
neer. 


t 



Indicates that you will now be prompted for changes to each field as 
described above. Answering IreturnI to a prompt leaves the data un¬ 
changed and presents the next prompt. At any time you may avoid 
further prompting by entering |ctrlI [y1. 


DELETE Command 


The delete command removes the schedset definition of a program 
(abbreviated p), a user (u), a group (g), or a schedule (s): 

(type) (name) 


where the “type” of item is specified as p, u, g or s, followed by the name of 
the program, user, group or schedule. As insurance against error, you are 
prompted as follows: 

Delete (type) (name)? 


Only a y or yes response completes the deletion; n or IreturnI means 
“no.” 


When a program name is deleted, all references to that program defini¬ 
tion for users, groups, and schedules are also deleted. 

When a user name is deleted, only it is removed; the programs and/or 
groups that it references still exist. 

When a group is deleted, only that group name is removed; the program 
names it references still exists. 


When a schedule is deleted, all run times for the program are removed; 
the program definition is unaffected. 
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LIST Command 

The List command prints the names and descriptions of all items of the 
type specified: 

/LIST [type] [DETAIL] 

where “type” is the type of item—programs, groups, users, schedules—to 
be listed. If you do not specify a type, all items for all types are listed in this 
order: 

Currently scheduled programs 
Currently defined programs 
Currently defined groups 
Currently defined users 

The detail (or d) modifier may be used only when a type is specified. It 
lists the detailed information for all items: 

1. for schedules, all scheduled programs are listed with their run times; 

2. for programs, all programs are listed alphabetically, followed by their 
definition information; 

3. for groups, all groups are listed alphabetically with the programs as¬ 
signed to each group; 

4. for users, all users are listed alphabetically, followed by lists of their 
accessible groups and programs. For example: 

/l u d 

to list the details of all users. 

USER Command 

Programs and groups are made accessible to users, and this informa¬ 
tion is modified, with the user command. Enter the command followed by 
the new or existing user name: 

/u (name) 

If the name entered (“Ralph," for example) is not currently defined, you are 
prompted: 

User RALPH has no accessible programs. 

To add or delete access to a program or group, enter its name. 
Program or group: 

Enter the name of a previously defined program or group, followed by 
(return]. As long as you make entries, you will continue to be promp ted 
indefinitely with “Program or group:” until you reply with |return| or 
IctrlI fy], either of which will return the / prompt for a new command. 

If programs and/or groups are already defined for the user whose name 
is entered, a summary of accessible groups and programs is given, fol¬ 
lowed by the “To add or delete ...” prompt. To add program or group 
names, enter ones that have not been listed for the user. To delete a 
name, enter one that has been listed; you are further prompted: 

Delete access to ('group' or 'program') (name)? 

Only a y or yes response finalizes the deletion; n or IreturnI means “no.” 
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Following the addition or deletion of program or group names for a user, 
it is advisable to execute the user command a ’second time to confirm 
currently accessible groups and programs for that user. The fastest way of 
doing this is with the fc command, followed by two Returns: 

/fc 

1RETURNI 
/u ian 

1 return] 

User IAN etc. ... 

GROUP Command 

Groups are created and program names are added or deleted with the 
Group command, which operates in a manner similar to the User com¬ 
mand. Enter the command followed by the new or existing group name: 


/g (name) 

If the name entered (“Classified,” for example) is not currently defined, you 
are prompted: 


Description: 

Enter a description of up to 44 characters. 


To add or delete access to a program, enter its name. 

Program: 

As with the user command, you will continue to be prompted with “Pro¬ 
gram:” indefinitely, until you reply with IreturnI or IctrlI 0, either of 
which will return the / prompt for a new command. 

If programs are already defined for the group whose name is entered, a 
list of the programs is given, followed by a prompt for a new description 
and the “To add or delete ...” prompt. To add new programs to the group, 
enter ones that have not been listed. To delete a program name, enter one 
that has been listed; you are further prompted: 


Delete access to program (name)? 

Only a y or yes response finalizes the deletion; n or IreturnI means “no." 

After making additions or deletions, you may get a confirmation list of 
programs currently defined for the group by entering the fc command, 
followed by two Returns. 

SCHEDULE Command 

A program is scheduled for automatic execution with the schedule 
command. Enter the command followed by the name of the program: 


/s (name) 
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If the name entered (“Payroll,” for example) is not currently scheduled, you 
are prompted: 


Program PAYROLL is not currently scheduled 
Which days? 

You have the choice of responding with days of the week, or with specific 
dates of the month (you may not mix the two in a single specification). 

If you respond with Ireturni . giving no specification, the following 
message is printed: 


Daily runs assumed. 


Weekdays are specified by entering the names of the days, divided with 
commas—monday, tuesday, Wednesday, etc. Only as many characters 
need be entered as are required to distinguish the word, m, w and f are 
unique abbreviations of Monday, Wednesday and Friday; t and s are not 
unique. Tuesday and Thursday must be abbreviated as tu and th; and 
Saturday and Sunday must be abbreviated as sa and su. 

Dates of the month are specified with numbers, divided with com¬ 
mas—1 , 3, 5, 7, etc. Since these dates are monthly, you are cautioned to 
not enter numbers greater than 28. (If you enter 29, February will be 
skipped except on leap years; if you enter 30, only February will be 
skipped; if you enter 31 , February, April, June, September and November 
will be skipped.) 

Note: Specifications must be given for either of the parameters Period or 
Run time (not both). If both are omitted, the schedule will not be 
saved. These are required to arrive at specific execution time(s). 


Period? 

This specification, too, is optional. You may state how often the program is 
to be executed on the days/dates (or daily) previously specified. This value 
is specified in minutes: 15 = every 15 minutes; 60 = once an hour; 720 = 
every 12 hours, or twice a day. 

If a period is specified, you are prompted: 

Range? 

You may specify a range of times as hours of the 24-hour clock' “0100 
0600” means 1 a.m. through 6 a.m. If you specify no range, the following 
message is printed: 


Entire day assumed. 


If you have not specified a period you will be prompted for specific run 
times: 


Run time: 


You must specify at least one run time, either here or as periods within a 
range of time. Run times are entered as hours of the 24-hour clock: 0000 
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= midnight, 0330 = 3:30 a.m., 1450 = 2:50 p.m. If you make an entry, 
the prompt will continue to be presented indefinitely until you respond with 
Ireturni , which will revert to the / prompt. 

This is the end of the prompting. The specifications will now be saved 
and the program is scheduled. 

If the program whose name is entered with the schedule command is 
already scheduled, a summary of the scheduling information is given, 
followed by the prompt: 

Add or delete run times? 

% 

There are three choices: 

1. a to add times, 

2. d to delete times, or 

3. Ireturni to make no changes. 

If you specify add or delete, you will be given the “Which days,” “Period” 
and “Run time” prompts. 

Adding and deleting times must be done with separate executions of the 
schedule command. Day/time and date/time combinations are unique. 

If you wish to change Wednesday at 0300 to Thursday at 0300, you 
must delete Wednesday in one pass and add Thursday and 0300 in a 
second execution of the command. The fc command, followed by two 
Returns, provides a speedy means of reexecuting the last command. 

Example #1 : Our imaginary company runs a special classified advertising 
report program twice each month. We wish to schedule this program 
(report) for the 1st and the 16th of each month at midnight. It is assumed 
that: 1) the operator has prepared the line printer on the evening prior to 
each run, and 2) the computer room or the room containing the line printer 
is locked. The report is ready for distribution on the mornings of the run 
days. 

We schedule the program as follows: 

Which days? 1,16 
Per i od? none specified 

Run time: 0000 

The next time we execute the schedule command for this program: 

/s report 
Program: REPORT 

Program is run on 1, 16 at: 

00 : 00 

Add or delete run times? 

Example #2: It is highly recommended that program refresh run every 
15 minutes on all systems. We specify this as follows: 

which days? Ireturni 
D aily runs assumed. 

Period? 15 
Range? [RETURNj 
Entire day assumed. 
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The run times are computed from the period within the range (entire 
day). Reexecuting the Schedule command for this program prints: 

/s..refre_sh 

Program: REFRESH 

Program is run daily at: 


o 

o 

00 

00: 

15 

00: 

30 

00: 

45 

01: 

00 

01: 

15 

01: 

30 

01: 

45 

02: 

00 

02: 

15 

02: 

30 

02: 

45 

03: 

00 

03: 

15 

03: 

30 

03: 

45 

04: 

00 

04: 

15 

04: 

30 

04: 

45 

05: 

00 

05: 

15 

05: 

30 

05: 

45 

06: 

00 

06: 

15 

06: 

30 

06: 

45 

07: 

00 

07: 

15 

07: 

30 

07: 

45 

08: 

00 

08: 

15 

08: 

30 

08: 

45 

09: 

00 

09: 

15 

09: 

30 

09: 

45 

10: 

00 

10: 

15 

10: 

30 

10: 

45 

11: 

00 

11: 

15 

11: 

30 

11: 

45 

12: 

00 

12: 

15 

12: 

30 

12: 

45 

13: 

00 

13: 

15 

13: 

30 

13: 

45 

14: 

00 

14: 

15 

14: 

30 

14: 

45 

15: 

00 

15: 

15 

15: 

30 

15: 

45 

16: 

00 

16: 

15 

16: 

30 

16: 

45 

17: 

00 

17: 

15 

17: 

30 

17: 

45 

18: 

00 

18: 

15 

18: 

30 

18: 

45 

19: 

00 

19: 

15 

19: 

30 

19: 

45 

20: 

00 

20: 

15 

20: 

30 

20: 

45 

21: 

00 

21: 

15 

21: 

30 

21: 

45 

22: 

00 

22: 

15 

22: 

30 

22: 

45 

23: 

00 

23: 

15 

23: 

30 

23: 

45 


Add or delete run times? 


Running Programs Non-interactively 

Recall that in the discussion of the program command it was pointed 
out that the prompt “Should vcontrol wait after process has stopped?” 
applies to programs that list or print information on the user’s vdt. Such 
programs are defined to run without user interaction (although under differ¬ 
ent circumstances they may be run interactively); they perform their as¬ 
signed task(s) and then exit automatically. 

Answering yes to the “Should vcontrol wait ...” prompt, causes the 
display to remain undisturbed after the program exits. The user may roll 
through the list(s) printed by the program and press the Icmd| key when he 
is ready to return to the List of Processes. 

If this question were answered no, the vdt control process vcontrol 
would clear the screen and return to the List of Processes as soon as the 
program exits and the user would not have the opportunity to read the 
program’s output. 

When a wait is specified, the message “vcontrol waits after program 
stops” is printed in the summary of program data when the Program 
command is executed a subsequent time (following initial definition). 

The function of this prompt is, therefore, critical to the operation of 
programs that supply information to the user. 

Program B as an Example 

An obvious example of a program using this feature is b. This program, 
which is not an interactive program, is able to report busy users and items 
in various ways depending on the startup message or command it is given 
at execution time. 

First, let us examine how the startup messages are entered and used 
when the program is executed with the Sll Command Interpreter. 
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There are three possibilities: 

1. no command, 

2. the command users, and 

3. the command summary. 

Since b is not a program with which the user may interact, the com¬ 
mands must be entered immediately following the program name as a 
startup message: 

; b 

When entered with no startup message, the program will list only active 
user/item combinations for each system with a summary of the number of 
signed-on users and the number of busy items for each system. An active 
user is one with a take displayed on his vdt. An active item is a take being 
displayed or one that has been submitted to a process such as just, 
spell or save (all takes being processed or waiting to be processed). 

; b..users 

When entered with the users startup message, signed-on users are listed 
separately from active user/item combinations and a summary is also 
given. This is advantageous because it reports users who are signed on 
but not currently accessing takes. Those users who are not considered to 
be 'busy” may in fact be actively viewing a directory or an index, or 
executing an interactive program or combining stories from directories. 

;b summary 

When entered with the summary startup message, the program lists a 
summary for each logical system—of the number of signed-on users and 
the number of busy items. This summary is a useful measure of general 
system activity. 

Defining this Program for SCHEDSET 

Now we may apply our knowledge of how program b is designed to run 
to program definitions (one for each method) with the schedset program 
command. We will assign each application a name matching its startup 
message. (Please consult your Sll System Engineer for the correct default 
volume name for your system.) 

First, we define the program to run without parameters: 

/p..b 

Program: B 

Program description: List busy items bv system 
Program file name: Ssystem.system.b 
Should VCON'TROL wait after process has stopped’’ y 
Startup message? EOF: 

Next, we define the program to run with the users parameter: 
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/p__users 
Program: USERS 

Program description: List_busy..users._and__iterns 
Program file name: Ssyste$L_system._b 
Should VCONTROL wait after process has stopped? y 
Startup message? users 
Process name: EOF! 

Finally, we define the program to run with the summary parameter: 

/p_summary 
Program: SUMMARY 

Program description: Summarize_.busy__use£S__and..items 
Program file name: $system,_system,_b 
Should VCONTROL wait after process has stopped? y 
Startup message? summary 
Process name: EOF! 

These three “programs"— b, users, and summary— may now be made 
available to users who require this information. Not only is this more 
convenient and faster than executing program b with SI I Command Inter¬ 
preter, but the information may be made available to users who do not 
have Command Interpreter authority. 

Program SCHEDSET as an Example 

A likely candidate for this application is program schedset itself. It is a 
convenient example because we have just seen how the list command 
operates interactively. Let us examine methods for obtaining a detailed list 
of users. 

If we were executing schedset interactively, we would enter (for clarity, 
no abbreviations): 


list use r _detai1 

To execute the program non-interactively through the SI I Command Inter¬ 
preter, we would enter: 


; s c h e d s e t _ 1 _i s t. _ u s e r _. d e t a i 1 

where list user detail is the startup message. The program will print the 
list of users and then exit. 

Now we may use the same startup message —list user detail— in 
defining a “program" named usermenus for schedset: 


/P..Usermenus 

Program: USERMENUS 

Program description: SCHEDSET _grpups_.and_.p.rpgrams..for. users 

Program file name: ^system- .system .schedset 

Should VCONTROL wait after process has stopped? y_ 

Startup message? list.user detail 
Process name: EOF! 

Program usermenus will now be a convenient means of obtaining this 
user/program/group information. Be aware that adding this to a user s List 
of Processes does not circumvent file security. Refer to Section 97 where 
we gave ownership of the data files used by program schedset to user 
sched.super. All of these files were secured in such a way that any user 
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could read them, but only the owner (or a user on another system with the 
same id) could write to them. When schedset is executed, however, it 
opens all required files for reading and writing; the program has no way of 
foreseeing the user’s intention to only read. (Read access by all users 
applies only to lists accessed with the index user command, where the 
access level of the list may still deny a user access.) Consequently, access 
to this program may only be given to users with the Tandem user name 
sched.super (id 101 , 255 ). To them it is a convenience only, since these 
users would probably have Command Interpreter authority. 

Additional Examples 

Program: LOGSWAP 

Description: swaps oprlog weekly 

$SYSTEM. SYSTEM.COMINT /IN $SYSTEM.OBEY.SWAPLOG, OUT $0, NAME 
$SWAP/ 

Default volume is $SYSTEM.SYSTEM 

No ASSIGN message(s) and no PARAM message(s). 

VCONTROL doesn't wait after program stops. 

Executes as TANDEM user SUPER.SUPER 
RETURN leaves a field unchanged 


Program: PROGREV 
Description: progrev 

SSYSTEM.SYSTEM.COMINT /IN $SYSTEM.OBEY.PROGREV, OUT $0, NAME 
$PREV/ 

Default volume is SSYSTEM.SYSTEM 

No ASSIGN message(s) and no PARAM message(s). 

VCONTROL doesn't wait after program stops. 

Executes as TANDEM user SUPER.SUPER 
RETURN leaves a field unchanged 

Program: LINEBUILD 

Description: linebuild 

SSYSTEM.SYSTEM.LINEBLD /IN . . , OUT . . / 

Default volume is SSYSTEM.SYSTEM 

No ASSIGN message(s) and no PARAM message(s). 

VCONTROL doesn't wait after program stops. 

Executes as TANDEM user NULL.NULL 
RETURN leaves a field unchanged 

Scheduling an Obey File for Execution 

To schedule an obey file, enter Ssystem.system.comint as the pro¬ 
gram file, then the name of the obey file. 

Useful Lists 

Standard lists of schedset information that may be accessed with the 
index user command include: 

• sched progs on Advertising systems 

• prog groups on Editorial systems 

• prog users on Editorial systems 

SCHEDSET Error Messages 

The following error messages may be given while you are using sched¬ 
set. Most messages occur immediately following the command entry that 
generated the error. 
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“Entry too long”—The name or description entered is too long. Names are 
limited to 12 characters, descriptions to 44 characters. 

“Fatal i/o error in [file name]”—There has been a hardware failure, the disk 
drive is not working, the file is full, and so on. Notify your System 
Manager. 

“Group with same name exists”—Group names must be unique. 

“Illegal group name”—Group names are limited to alpha and numeric 
characters in one word. No spaces are allowed. 


“Illegal parameter"—The command requires a program, group, user, or 
schedule name following the appropriate type modifier. A character 
typed in the parameter part of the command is illegal. Names consist 
only of alpha and numeric characters. 

“Illegal program name”—Program names are limited to alpha and numeric 
characters in one word. No spaces are allowed. 


“Internal error in program”—A program error. Notify your System Manag¬ 
er. 


“Invalid defaults”—The $<volume).(subvolume) specified for the Default 
volume prompt of the Program command is in the incorrect format. 


“Invalid process name”—The name entered in response to the “Process 
name” prompt of the Program command is not in the proper format. 

“Invalid time format”—Applies to the “Range” and “Run time” prompts of 
the Schedule command. The time contains illegal characters or illegal 

values. 


“Missing parameter”—The command requires a program, group, user or 
schedule name following the appropriate type modifier. 

“No such entry”—The program, group, user, or schedule referenced has ■ 
not been defined. 


“No such group”—The group named in the command has not been de¬ 
fined for SCHEDSET. 

“No such program”—The program named in the command has not been 
defined for schedset. 

“No such program or group” —The program or group named in the com¬ 
mand has not been defined for schedset. 


“No such user”—The user named in the command has not been defined 
for schedset. 

“Not a unique command”—If more than one command begins with the 
same letters, enough characters must be typed to provide unique 
identification. (At present, no two commands begin with the same 
letter.) 

“Not a unique command modifier”—If more than one command modifier 
begins with the same letters, enough characters must be typed to 
provide unique identification. (Modifiers are program, group, user, 
and schedule. At present, no two of them begin with the same letter.) 


“open failed for [file name]”—Either the file does not exist or you do not 
have the authority to access it. Notify your System Manager. 


“Program file name must be specified”—An entry is required for the Pro¬ 
gram file name” prompt of the Program command. 
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“Program with the same name exists"—Program names must be unique. 



u 


Too many assign messages to store”—Applies to the storage of cobol 
assign messages during program definition. Only ten messages are 
allowed. 


“Too many parameters to store”—Applies to the storage of cobol param¬ 
eter messages during program definition. Only ten messages are 
allowed. 


“Unexpected character”—An illegal character has been typed somewhere 
in the command line, preventing it from being interpreted. 

“Unrecognized command”—The characters of the first word typed on the 
command line do not match those of a schedset command. 

“Unrecognized command modifier”—Wrong syntax. The modifier speci¬ 
fied does not exist or was incorrectly abbreviated. (Modifiers are the 
types program, group, user, and SCHEDULE.) 

“User name must be specified”—The User command requires a new or 
existing user name to be specified. The Delete command, if modified 
a by user, requires an existing user name. 
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SECTION 88 

STTY 

Standard Disk File Name: SSYSTEM.SYSTEM.STTY 
Process Revision Level : SOI 15.A06.006 (002) 

Description 

stty is an Sll utility used for temporary (in cpu memory) modification of 
data communication parameters for asynchronous devices. The ftm and 
xtm utilities allow modification of data communications parameters for Sll 
controllers (see Section 72 and 95, respectively). 


CAUTION 

Improper use of this utility can cause communica¬ 
tion to devices to fail. Secure accordingly 


Execution Syntax 

To run stty, start Sll Command Interpreter and enter stty in response 
to the semicolon prompt. 


; sttv 

Figure 88.1 . Starting Process stty 


STTY HELP Command 


The stty help command prints a list of the available commands as 
illustrated in Figure 88.2. If a command is specified (for example, “help 
baud”) a more detailed description of that command is given. 


: stty 

* * * S T T Y * * * 

- REVISION: SOI15. 

A06.006 l002i 


>help 

ALL 

ASSERTDTR 

AUTOCR 

AUTOD 

BAUD 

BREAKAFTER 

BREAKBITS 

BREAKCOUNT 

! BREAKENABLE 

BREAKMODE 

BSCRT 

BSERASE 

BSHARD 

CDDELAY 

CHAR 

CHECK 

CLOCK 

COMPARE 

CONV 

CRC 

CRLFD 

CTSASSERT 

CTSDELAY 

CTSDROP 

DELAYDTR 

DMA 

DSRDROP 

DCAL212 

ECHO 

ETXTERM 

EXIT 

FC 

HARD 

HDTURN1 

HDTURN2 

HELP 

HISTORY 

LFSYS 

LFTERM 

LINETERM 

LRC 

MODEM 

NOASSERTDTR 

NOAUTOD 

NOBS 

NOCHECK 

NOCOMPARE 

NODELAYDTR 

NOD.MA 

NOECHO 

NORMAL 

NORTSCTS 

NOWPB 

i 

PAD1 

PAD 2 

PAGE 


Figure 88.2. stty help Command (partial) 
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PAGETERM 

RS232 

STOPBITS 

STRIP3 

TERM 

TRANSPARENT 


PARITY 

RS422 

STORE 

STRIP4 


TIMEOUT 

VTAB 


PPOLL 

RTSCTS 

STRIP1 

SYNC1 

TPAUSE 

WPB 


PRESPACE 


SHOW 

STRIP2 

SYNC2 

TRACE 


Figure 88.2. stty help Command (concluded) 


Detailed Command Explanations 
(listed alphabetically) 


The assertdtr command specifies to assert dtr. This command is for 
tpm lines only. 

The auto command specifies to disconnect the line after carrier detect is 
lost. This command is for tpm and term lines only. 

The autocr command specifies whether a carriage return is to be trans¬ 
mitted terminal if lfterm is selected. Only for term lines. 

the baud command specifies the baud rate, the valid baud rates are: 50, 
75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 
7200, 9600, and 19200. The defaults are: tpm, 1200; term, 9600, 
and comm, 2400. 

The breakafter command has not been implemented. 

The breakbits command had not been implemented. 

The breakcount command specifies that the transfer count is to be 
included with the file system break status for read requests. Only for 
term lines. 

The breakenable command has not been implemented. 

The breakmode command has not been implemented. 

The bscrt command specifies a video terminal that backspaces. Only for 
term lines. 

The bserase command specifies a video terminal that erases when back¬ 
spacing. Only for term lines. 

The bshard command specifies a hard copy terminal that backspaces. 
Only for term lines. 

The cddelay command specifies the wait time for cd while connecting. 

The value is specified in .01 second units. This command is for tpm 
lines only. 

The char command specifies the size of the characters in bits. The values 
are: 5, 6, 7, 8. The defaults are: tpm, 7; term, 7, and comm, 8. 

The check command enables parity checking. The defaults are: tpm, 
nocheck; term, check, and comm, nocheck. 

The clock command specifies whether interna! clocking is to be used or 
external clocking to be supported. For external clocking the valid 
modifiers are externxi, externxi6, or externx64. This command 
is for tpm lines only. 

The compare command specifies to check the strip termination char¬ 
acters. This command is for tpm and term lines only. 
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The conv command sets the terminal into conversational mode. This is 
only available on lines that are term. 

The crc command sets the generation of 16 bit crc characters. This 
command is for tpm lines only. The default is lrc. 

The crlfd command specifies the delay time for carriage return/line feed. 
Value is in .01 second units. t)nly for term lines. 

The ctsassert command specifies the wait time for cts after asserting 
rts. The value is specified in .01 second units. This command is for 
tpm lines only. 

The ctsdrop command specifies the wait time for cts after dropping rts. 
The value is specified in .01 second units. This command is for tpm 
lines only. 

The ctsdelay command specifies the wait time for cts while connecting. 
The value is specified in .01 second units. This command is for tpm 
lines only. 

The delaydtr command specifies to delay asserting dtr until i/o. This 
command is for tpm lines only. 

The dma command specifies to dma characters to memory. This com¬ 
mand is for tpm lines only. The default is dma. 

The dsrdrop command specifies the wait time for dsr after dropping dtr. 
The value is specified in .01 second units. This command is for tpm 
lines only. 

The DUAL212 command that the line is connected to a bell 212 type 
modem, and allows the term process to detect the baud rate and 
set the baud rate at 300 or 1200 accordingly. Only for term lines. 

The echo command enables the echoing of input characters. The default 
is echo enabled. 

The etxterm command specifies the number of bytes after the etx to 
terminate. Value is as follows: 0 = do not terminate on etx; 1 = one 
byte after etx; and 2 = two bytes after etx. 

The exit command (or typing eof!) causes stty to stop. If this command 
is issued before a store command, all changes are ignored. 

The hard command specifies that this line is connected hard and is either 
half or full duplex. 

The hdturni command specifies the first half duplex modem turnaround 
character. Value is in octal. Only for term lines. 

The hdturn2 command specifies the second half duplex modem turn¬ 
around character. Value is in octal. Only for term lines. 

The history command is normally issued before the term command. It 
specifies whether or not to log all commands when running stty. The 
output goes to a spooler location Ss.#stty. By using the history 
command, you can keep track of what a line looked like before, 
during, and after modifications have been made using stty. 

The lfterm command specifies the terminal supplies the line feed. Only 
for term lines. 

The lfsys command specifies that the system supplies the line reed. Only 
for term lines. 
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The lineterm command specifies the character that is to be used as the 
line terminator. Value is octal. Only for term lines. 

The lrc command sets the generation of 8 bit lrc characters. This 
command is for tpm lines only. The default is lrc. 

The modem command specifies that this line is connected to a modem and 
is either half or full duplex. 

The noassertdtr command specifies not to assert dtr. This command is 
for tpm lines only. 

The noauto command specifies not to disconnect the line after carrier 
detect is lost. This command is for tpm and term lines only. 

The nobs command specifies a hard copy terminal that does not back¬ 
space. Only for term lines. 

The nocheck command disables parity checking. The defaults are: tpm, 
nocheck; term, check, and comm, nocheck. 

The nocompare command specifies not to check the strip/termination 
characters. This command is for tpm and term lines only. 

4 The nodelaydtr command specifies not to delay asserting dtr. This 
command is for tpm lines only. 

The nodma command specifies not to dma characters to memory. This 
command is for tpm lines only. The default is dma. 

The noecho command disables the echoing of input characters. 

The normal command specifies normal text mode. This command is for 
tpm lines only. 

The nortscts command specifies not to support the rts/cts handshake. 
This command is for tpm lines only. 

The nowpb command specifies to use byte for byte in the buffer. This 
command is for tpm lines only. 

The padi command sets the first pad character. The value passed is in 
octal. This command is for tpm lines only. 

The pad2 command sets the second pad character. The value passed is in 
octal. This command is for tpm lines only. 

The page command sets the terminal into page mode. This command is 
not available on tpm or comm lines. 

The pageterm command specifies the character that is to be used as a 
page terminator. Value is in octal. Only for term lines. 

The parity command specifies the parity to be generated: even, odd, or 
none. The defaults are the following: tpm, odd; term, even, and 

COMM, NONE. 

The ppoll command specifies whether the file system is to automatically 
trigger a pseudo-polled terminal, and if so, what the trigger character 
is that is required by that terminal. The value is in octal. If %000 is 
specified, then the terminal is not pseudo-polled. This command is for 
term lines only. 

The prespace command has not been implemented. 
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The rev command is used for reverse polarity tpause checking); or the 
revxon command for both. For term lines, specify on, off. or rev; 
for comm lines, specify on or off. 

The RS232 command specifies to support eia RS232. This command is for 
tpm and term lines only. 

The RS422 command specifies to support RS422 for tpm lines and cur¬ 
rent loop for term lines. This command is ignored for comm lines. 

The rtscts command specifies to support the rts/cts handshake. This 
command is for tpm lines only. 

The show command lists the parameters for the line that is to be modified. 
A show command can be issued anytime. This is helpful to see what 
the old parameters are and what the new line parameters will be. 

The stopbits command allows you to specify the number of stop bits 
generated when data is output. Value for tpm and comm lines are 1 , 
1.5, or 2. For term lines the values are 1 or 2. The default is 1 
Stopbit. For term lines with a baud rate of 110, 2 stopbits are 
always generated. 

The store command does the actual modification for the line that was 
specified by the term command. The modifications are made in 
memory, and do not remain after a processor reload. 

The STRipn commands set the terminator/strip characters. These char¬ 
acters are terminator characters if the high-order bit is off (for exam¬ 
ple %3 = etx), and strip characters if the high-order bit is on (for 
example, %200 = null). The value for n is 1 - 4. The value is in 
octal. This command is for tpm and comm lines only. 

The synci command specifies to use one sync character. This command 
is for tpm lines only. 

The SYNC2 command specifies to use two sync characters. This command 
is for tpm lines only. 

The term command specifies the name of the line to be modified. Checks 
are made to see if the line you specified is a valid line. 

The timeout command specifies the character timeout value. The value is 
specified in .01 second units. This command is for tpm lines only. 

The tpause command enables,disables tpause checking. On tpm ucia 
lines, you may specify xon (for xon. xoff checking). 

The TRACE command allows you to enable and or disable the i/o trace 
feature of a tpm line. It also enables you do dump the contents of the 
i/o trace table. Action is on, off. or dump. 

The transparent command specifies transparent text mode. This 
command is for tpm lines only. 

The VTABD command specifies a time period that a terminal is inacces¬ 
sible after a form feed or vertical tab character. Value is in .01 second 
units. Only for term lines. 

The wpb command specifies to use one word for each byte in the buffer. 
This command is for tpm lines only. 
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>term SSLP 

TPM PROCESS. LINE = SSLP. PRIMARY = 01.013 BACKUP = 00.013 LDEV = 15. SYNC-I.RC. I1S232 
BAUD 2400. CHARS. NOECHO. NONE. NOCHECK. TPAUSE ON. TRANSPARENT. TIMEOUT = 01O00 
HARD. NO AUTO. RTSCTS. NODELAY DTR. NOASSERTDTR, INTERNAL. SYNC2 

CTSASSERT = 00030, CTSDROP = 00010, DSRDROP = 00500. CDDELAY = 03000. CTSDELAY - 03000 

STRIP, TERM CHAR = r r012. %015. ‘1000, ^000. PAD CHAR = %015. ^012 

DMA. NOWPB, COMPARE. ETXTERM 0 

>baud 1200 

>char 7 

>show 

TPM PROCESS. LINE = SSLP. PRIMARY = 01.013 BACKUP = 00.013 LDEV = 15. SYNC-LRC. RS232 
BAUD 1200. CHAR". NOECHO. NONE. NOCHECK, TPAUSE ON. TRANSPARENT. TIMEOUT = 01000 
HARD. NO AUTO. RTSCTS, NODELAY DTR. NOASSERTDTR. INTERNAL. SYNC2 

CTSASSERT = 00030. CTSDROP = 00010. DSRDROP = 00500, CDDELAY = 03000. CTSDELAY - 03000 
STRIP/TERM CHAR = %012. 7o015. 7 o OO0. 'MJOO. PAD CHAR = %015. ^012 
DMA. NOWPB. COMPARE. ETXTERM 0 

>store ___ 

Figure 88.3 Commands to Change Baud Rate and Number of Bits per Character for Device $slp 
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The following new command has been added which can be used in conjunction 
with the load command: 

newnumbers -- To assign sequential story numbers. 

add - To restore random stories which have been “lost” or to restore some stories which 
were archived on tape. 

The stories selected from the tape are added to the data base. Each selected sto¬ 
ry is given a new story number without regard to the story number which identified 
the story at the time it was saved. If possible, the name of the story as it existed is 
preserved. 

The add command can be used without interrupting the normal use of the System. 

update --To perform a “roll forward” operation. (That is, when your tape contains 
all of the changes that have been made to the data base from some point in time, 
and the data base has already been restored to the point where only the changes 
are missing.) 

Stories from the tape are used to update the data base. It is assumed that the 
most current information is recorded on tape -- not in the “current” data base. 

During an update operation, the header file is locked. This inhibits the use of the 
text data base until the operation is completed. 

Story numbers are always preserved during an update operation. (For example, if 
there is a story#100 on the tape, it will either overlay any existing story #100 or it 
will be added to the header file as story #100.) 

Story names are always preserved during an Update operation. (For example, if 
there is a story #100 on the tape called “my story”, it will be restored as story 
#100 and will be called “my story”. 

Note: There might be another story in the data base, say story #200, which is also 
called “my story”. Since this would prevent story #100 from being restored with its 
proper name, the other story, #200, is updated to remove its name prior to restor¬ 
ing #100. 

Performance improvements: A header file disk access has been eliminated for 
each audit copy of a story restored. If audit copies are not restored, there is no 
benefit to this improvement. Note that frequent story name conflicts can slow 
down an update operation. 

Note: Because the header file is locked, the normal header update process (up- 
dateh) cannot be used to update the header file. This means that extract files will 
not be properly maintained and will have to be recreated after the update is com¬ 
plete. 
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load --To restore the entire data base. (That is, when the header and text files 
are defined but empty.) 

A load operation is not permitted unless the header file is empty (End of File 
[EOF] = 0). In addition, the alternate key files must also be empty or they must 
have the noupdate attribute. We recommend that you always use the noupdate 
attribute. Story names are always preserved during a load operation. 

Story numbers can be reassigned at the user’s option (This is not recommended if 
you are restoring a classified system). If the option is exercised, the first story on 
the tape is restored as story #1, the second as story #2, etc. A new “set” com¬ 
mand has been added so that this parameter can be specified: 

SET NEWNUMBERS OFF (which is the default). 

SET NEWNUMBERS ON (which causes new, sequential story numbers to 
be assigned). 

During a load operation, the header file is locked, thereby inhibiting use of the text 
data base until the operation is complete. 

Performance Improvements: For each story restored, one header file read and 
one header file write has been eliminated. In addition, for each audit copy of a sto¬ 
ry restored, one more header file read has been eliminated. 

Note: Because the header file is locked, the normal header update process (up- 
dateh) cannot be used to update the header file. This means that extract files will 
not be properly maintained and will have to be recreated after the load is com¬ 
plete. 

Note: If the noupdate attribute is used on the header alternate key files, then 
these alternate key files must be reloaded after the load is complete. 

3. TAPE again works when run from the job stream 

Problem: 

When the auto-update procedure was developed, tape was changed to prompt 
for input when the input file was a process. When the tape program attempted to 
write a message back to the job stream (a process), it was ignored and nothing 
was accomplished. 

Solution: 

TAPE now prompts for input only if the input file is a terminal, or if the parameter 
“prompt” is supplied after the tape device name, as in: 

:tape $tape; prompt 

This corrects the situation. 
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4. New command lets user change device more easily 

tape no longer requires that the name of the tape device be specified in the pa¬ 
rameter string, although you may continue to do so. A new command has been 
added (set device) which allows the user to specify or change the device name. 

For example: 

♦set device $tape 

If you attempt to execute a command which requires a device (like 
list/save/restore) and have not yet specified one, the following message will be 
displayed: 

No device has yet been specified 


5. Tape’s specified device is now more flexible 

tape no longer requires that its “tape” device actually be a tape drive. Now tape is 
much more flexible, allowing its device to be a process or an unstructured disk file 
as well as a tape drive. 

Allowing the tape device to be a disk file will help sites backup and restore their 
data base more quickly. Placing the file on a demountable disk allows the disk 
pack to be removed for storage after tape has saved all the desired stories. 

;create $data.dfw.test,10 
; tape 

♦set dev $data.dfw.test 

TAPELEN has been reset to 4096 

♦sys siip 

♦t dfw’s test 

♦path ba dfw 

♦save 


Start of tapeset DFW'S TEST, SII system: P 
Tape written on 2/04/85 at 9:35:15 (SII) 


Story 

Number 

Story 

Name 

Basket 

Desk 

Author 

Reel 

#18051 

BOO stuff 

DFW 

TANDEM 

DFW 

1 

#17971 

d 

DFW 

TANDEM 

DFW 

1 

#2908 

d filter 

DFW 

TANDEM 

DFW 

1 

#2909 

dfw pending 

DFW 

TANDEM 

DFW 

1 

#15014 

fri 13th 

DFW 

TANDEM 

DFW 

1 

#2911 

halts 

DFW 

TANDEM 

DFW 

1 
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#16887 

killer 

DFW 

COYOTE 

SYE 

1 

#14538 

machine room 

DFW 

TANDEM 

DFW 

1 

#7181 

reverse pass 

DFW 

TANDEM 

DFW 

1 


9 stories saved. 
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SECTION 89 

TAPE 

Standard Disk File Name: SSYSTEM.SYSTEM.TAPE 
Process Revision Level: S0084.E03.001 (027) 

Description 

tape is an interactive process used to save takes from disk to magnetic 
tape for backup purposes. The tape is then removed for storage and 
possible recovery later. Because of the significance attached to long-term 
storage, extreme care must be taken to ensure both proper data transfer to 
tape and proper storage of the reel once filled. 

Magnetic Tape Organization 

A magnetic tape may be logically divided into several areas (see Figure 
89.1). Areas where takes are stored are called sets. While each set is 
logically separated and each system is unique, it should be noted that two 
consecutive tape sets may contain takes saved from different systems. 
Each set begins with some identifying information such as its parent 
system, the date and time it was written, the set name and so forth. This 
identifying information is followed by the take information. 



Figure 89.1 Magnetic Tape Organization. 
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Execution Syntax 

To run tape, start Sll Command Interpreter and enter tape in response 
to the semicolon prompt. 


TAPE -- SII tape utility program 
♦tape 

Figure 89.1. Starting Process tape 

When the process starts, the process prompt, an asterisk, is displayed. 
To specify the data that is to be saved to tape, enter the commands at the 
prompt (Figure 89.2). 


* sys t em siie 

*. ap e s e t _ e d i t o r _i a 1 

*.. I! ® 1 a c t d e s k" n am e = ' 'wire" 

*saye 

Figure 89.2. Running tape interactively 

Exiting TAPE 

You can exit tape at any time by pressing IctrlI 0 or entering exit in 
response to the process prompt. 

Help Command 


tape has a Help command. To use it, start the process, and enter help 
(see “Running tape Interactively” later in this section). All of the available 
commands and a brief description of each will be listed (Figure 89.3). 


*help 


ADD 

Restore stories from tape, adding them 

CLEAR 

Clear the select/reject conditions 

EOT 

Skip to end of the tape 

EXIT (or EOF!) 

Terminate execution of program 

FC 

Standard COMINT fix command 

HELP [(command)] 

Print long command descriptions 

LIST 

List the contents of a tape 

LOAD 

Restore stories from tape, reloading the database 

PATH path [key] 

Specify positioning information 

REJECT condition 

Set a story rejection condition 

RESTART [story #] 

Specify restart story number 

REWIND 

Rewind the tape 

RSCAN tapeset 

Scan backwards for a tapeset 

SAVE 

Save stories to tape 

SCAN tapeset 

Scan forward for a tapeset 

SELECT condition 

Set a story selection condition 

SET 

Allows you to set certain program variable values 

SHOW 

Displays the current values of certain program variables 

SYSTEM 

Specify the SII logical system name 

TAPESET 

Specify the tapeset name 

UPDATE 

Restore stories from tape, updating existing stories 

VERSION 

Print version information 

WAITED10 

Open disk files with true waited I/O 


Figure 89.3. tape Help Command 


To display a more detailed description of a specific command enter 

HELP (COMMAND NAME). 
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Available Commands 


SYSTEM 

The system command specifies the system from which stories are to be 
saved or restored. This command must be specified. 

* s y_ s t e m s i i e 


TAPESET 

The tapeset command specifies the name of the next set of saved or 
restored stories. This command must be specified. 

*iapese t wire 


The name of the set is written to tape along with the saved stories. 
When the restore command is executed, the tape is searched forward 
from the current tape position for the specified tapeset. 

A tapeset must start on the current tape, even though it may be split 
across several tapes. 

LIST 

The list command syntax is as follows: 

♦list [{tapeset name) or {ONLY TAPESETS)] 

where both parameters are optional. If neither parameter is entered, the 
program will list the contents of every tapeset from that point on and leave 
the tape positioned at the end of tape. 

If the (tapeset name) parameter is supplied, the program will only list the 
stories contained in that tapeset and position the tape at the start of the 
tapeset listed. 

If the special string only tapesets is specified, the list command will only 
list the names of the tapesets on the tape from that position on and leave 
you positioned at the beginning of the tape. 

You can halt a listing by pressing Icmdi . The prompt is returned so you 
may enter another command. The program returns to the beginning of the 
tapeset you were listing (if the program was currently listing the contents of 
that tapeset) or to the first tapeset on the tape (if the tapeset option was not 
specified or you pressed IcmdI before the tapeset was located). 

PATH 

The path command specifies positioning information used to select a 
portion of the header file for saving. The path is the same two letter 
mnemonic used with directory commands. 


BA 

basket name 

KE 

keyword 

DE 

desk name 

SN 

“story name”,compare length 

AU 

author’s name 

EX 

expiration date 

TO 

topic 



If no path is supplied, 

the entire header file is scanned, which 


considerable amount of time. The optional key may only be used with the 
specific paths listed above. Once a path is specified, it remains in effect 
until another path is specified or you use the clear command.. 
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The format of the key varies from path to path, as indicated below. For 
instance, the sn path may be used as follows: 

*path sn "class", 5 

In this example “5” is the number of leading characters the process will 
compare when selecting story names (the position of the asterisk if this 
were a directory prompt). This particular example selects all stories whose 
first 5 letters are “class” (classified, class dump, and so on). 

SET 


The set command allows you to set the variables listed below. If no 
variable is specified (set alone is entered) the program will prompt you for 
a new value for each variable. You may either enter a new value or press 
IreturnI to leave the variable unchanged. 

VARIABLE FUNCTION 


AUDIT [ON Or OFF] 

basket [basket*name] 
device [device name] 

NEWNUMBERS 
[ON or OFF] 
ORIGINALONLY 


saves or restores audit copies 

specifies the name of the basket to which stories 

are to be restored 

will specify the device to use. 

assigns sequential story numbers. 

toggles the saving of only the oldest audit copy 


[on or off] 

QUIET [ON or OFF] 

tapelen [tape block len] 
tapeset [tapeset* name] 

WHOLEHEADER 
ON or OFF] 


allows or prevents the program from listing each 

story as it is restored or saved 

sets the tape block size (record size) 

sets the tapeset name 

allows user to restore either complete header stored 
on the tape or only common part of story header 


SHOW 


The show command displays the state or value of the following vari¬ 
able^): 

VARIABLE STATE 


AUDIT 

BASKET' 

DEVICE 

NEWNUMBERS 

ORIGINALONLY 

QUIET 

TAPELEN 

TAPESET 

WHOLEHEADER 


(ON Or OFF) 

(current basket to change to) 

(current device name) 
assigns sequential story numbers 
(on or OFF) 

(on or OFF) 

(currently defined tape record length) 
(display the currently defined tapeset) 
(on or OFF) 


SELECT and REJECT 

The reject command specifies a condition that, if true for a story, 
causes it to be skipped, and not saved or restored. 

The select command specifies a condition that, if true for a story, 
causes the story to be saved or restored as appropriate. 

Up to 10 different select/reject statements may be in effect at one 
time. If none of the select reject conditions is found to be true, the 
information garnered from the previous test is used to determine story 
selection or rejection. If the last test indicated a select, stories failing that 
test will be rejected, and vice versa. 
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A condition is defined as any number of relations strung together with 
either and or or. A relation is either of two things: 


1. A header Q-field name, followed by a relational operator, followed by a 
constant value; or 


2. a complete condition enclosed in parentheses. 

The signed relational operators are: 

= Values of the operands are equal 

< Left value is less than right value 

> Left value is greater than right value 

< = Left value is less than or equal to right value 

> = Left value is greater than or equal to right value 

<> Values are not equal 

The unsigned relational operators are: 

> greater than 

> = greater than or equal to 

<= less than or equal to 

< less than 


Here are some sample expressions: 

SELECT carborfsend = "AP" or carborfsend = "SA” 
REJECT length < 2 

REJECT release^status = "R" and fi Inf status = ”F" 


Dates may be specified in the form mm/dd/yy or as today, tomorrow, 
yesterday, Tuesday, and so on. Dates specified in this fashion may be 
further modified by adding or subtracting a number of days for example: 


SELECT entry^date >= today - 3 
SELECT lasifdate >= yesterday -2 


Times may be specified in the form hh:mm:ss or as “now +/- n” where 
“n” represents a number of hours. To select stories entered since one hour 
ago: 

SELECT entry A time >= now - 1 


CLEAR 

The clear command eliminates the story selection/rejection conditions 
previously set by the select, reject, and path commands. 

Tape Control Commands 


REWIND 

The rewind command causes the process to rewind the tape. If the 
process is run interactively (from a terminal), the command merely starts 
the rewind. If the process is not being run interactively, it starts the rewind 
and waits. When rewind is complete, command processing begins anew. 


EOT 

The eot command causes the process to search for the logical end of 
the tape (not the eot marker). The tape is left positioned such that a save 
operation may be carried out. 
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Scan 

The scan command scans forward through the tape for the specified 
tapeset. Each skipped set is listed. If the selected set is not found, tape 
returns an error message. 

RSCAN 

The rscan command is similar to the scan command. This command 
scans backward through the tape for the specified tapeset. It lists all skipped 
sets and returns an appropriate error message if the set is not found. 

SAVE 

The save command begins saving stories to tape. Unless the quiet 
command has been given, each saved story will be listed on the terminal 
from which tape was executed (Figure 89.4). 


Start of tapeset 'sports'. HC system: e 
Tape written on 5/12/82 at 02:00:41 (HC) 


Story 

Number 

Story 

Name 

Basket 

Desk 

Author 

Reel 

#1132 

49ers 

SPORTS 

SPORTS 

RANDY 

1 

#1463 

% Raiders 

SPORTS 

SPORTS 

BOB 

1 

#1628 

Lakers 

SPORTS 

SPORTS 

JON 

1 

#1795 

LPGA 

SPORTS 

SPORTS 

PEGGY 

1 

#1954 

Track 

SPORTS 

SPORTS 

RALPH 

1 


94 stories in tapeset. 

Figure 89.4. Story Listing for a Single Tapeset 


ADD, LOAD, and UPDATE 

The add, load, and update commands begin restoring stories from 
tape. They search forward on the tape for the current set. If the set is not 
found on the tape, an error is given. The process will not request the next 
sequential reel while searching for the set. Once the correct set is found, 
the command requests the next reel if the set is split across several reels 
of tape. 

add —The add command is used to restore random stories that have been 
“lost” or to restore stories archived on tape. The selected stories from 
the tape will be added to the database. Each story is given a new 
story number without regard for the story number that identified the 
story at the time it was saved. If the story name is not currently in use 
when the story is restored to the system, it will be preserved. 

load —the load command is used to restore the entire database. The 
header and text files must be defined but empty. In addition, the 
alternate key files must also be empty or they must have the noup¬ 
date attribute. Story names are always preserved during a load 
operation. Story numbers can be reassigned if you wish (not recom¬ 
mended on a classified system) using the newnumbers option with 
the set command. If this is used, the first story on the tape is restored 
as story #1, the second as story #2, etc. 

During a load operation, the header file is locked, which inhibits use 
of the text database until the operation is complete. Because the 
header file is locked, the normal header update process cannot be 
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used to update the header file. Extract files will not be properly 
maintained and must be recreated after the load is complete. 

NOTE: If the noupdate attribute is used on the header alternate key 
files, those alternate key files must also be reloaded after the load is 
complete. 

update —The update command is used to perform a "roll forward to 
update the data base. It is assumed that the most current information 
is recorded on tape rather than on the current database. During an 
update operation, the header file is locked and the text database 
cannot be used. Story numbers and story names are preserved. If a 
story already on the system has the same number or name, it is made 
an oops copy of the updated story. 

NOTE: Because the header file is locked during an update operation, 
the normal header update process, cannot be used to update the 
header file. Extract files will not be properly maintained and must be 
recreated after the update is complete. 

Running TAPE from a Data Take 

The tape process can also be run from a data take. A typical data take 
for running tape, showing the manner in which the parameters are to be 
entered, is illustrated in Figure 89.5. Once the take has b een set up 
correctly, you may use it to run tape by outputting it (ICMDj [o]). When 
tape is run in this fashion, messages generated by the process are not 
logged on the terminal. They are sent to the out file specified in the startup 
parameters. 



Figure 89.5. Data Take to Run tape 


Examples 

Three recommended methods of file backup are described in the re 
mainder of this section. Each method dumps a different number of text files 
each time tape is run. and requires a different number of tape sets. Each 
method uses a seven-day cycle, with daily file backups. Transfer of files to 
tape is most conveniently made during periods of low system activity when 
it will cause only minimal disruption of normal activity. This also ensures 
that files are as nearly static as they ever become. 

Daily Transfer of all Files to Tape 

All text files in the system are dumped to tape daily. This method has the 
advantage of requiring only two tape sets to maintain complete file curren¬ 
cy. And, one tape set restores all files. On the other hand, the daily 
procedure is extremely time consuming. The format for a typical data take 
to perform this type of save is illustrated in Figure 89.o. 
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Story daily backup Topic _ Keyword _ 

Basket PRODUCTION Desk _ Author RICK _ 

Output DATA ( TANDEM ) 

tape/out (filename)/(device), [(configuration file)] 
system siie 
tapeset (name) 
save 

Figure 89.6. Data Take to Save All Files to Tape 

Daily Transfer of all Changed Files 

Ali files in the system are dumped to tape on the first day of the cycle. 
Then, on each succeeding day, only those files that are new or have been 
modified since the previous tape write are dumped. For example, if the 
cycle starts on Sunday, all files are saved. On Monday, all files changed on 
Monday are saved, and so on. This method is less time consuming than a 
daily dump of all files, since only those files that have been modified or 
entered that day are written to tape. However, this method requires a new 
tape set for each day of the cycle, plus one, even though sets containing 
partial backups are smaller than those used for a full backup. Writing from 
tape back to disk is slower and more complex with this method and could 
require up to seven tape sets. 

This method lends itself to the use of a data take or several data takes. If 
tape is run at the same time each day, early in the morning for example, 
one data take can be used to save all stories entered or changed on the 
preceding day. Use a convenient identifier for the tapeset, such as the date 
on which the save was made (Figure 89.7). 


Story daily backup Topic 

Keyword 

Basket PRODUCTION Desk 

Author RICK 

Output DATA (TANDEM ) 

tape/out (f ilename)/(device), [(configuration file)] 

system siie 
tapeset 5/05/82 
select entry'date = yesterday 
select last'date = yesterday 


save 



Figure 89.7. Data Take to Save AH Stories Entered or Changed “Yesterday” 


If you wish to be more specific, in saving stories you can use select and 
reject statements to select stories that have been entered or changed 
since the exact date and time that tape was last run. For example, if tape 
was last run to save stories at 2:05 am on 5/05/82 the data take to save ail 
stories entered or changed since that time might look like Figure 89.8. 


89.8 

























Utilities 


TAPE 


Story daily backup Topic _ Keyword 

Basket PRODUCTION Desk _ Author RICK 

Output DATA ( TANDEM ) 


tape/out (filename)/(device), [(configuration file)] 
system siie 
tapeset (name) 

select entry'date >= 5/05/82 
select entry^time >= 02:05 
select laslfdate >= 5/05/82 
select last'time >= 02:05 
save 

Figure 89.8. Data Take to Save all Stories Entered or Changed Since 5/05/82 at 2:05 am 


Daily Transfer of Files Changed Since Start of Cycle 

All files in the system are dumped on the first day of the cycle. On 
succeeding days, all files created or modified since the first day of the 
cycle are transferred to tape. For example, if the cycle begins on Sunday, 
all files would be saved on that day. On Monday, all files changed since 
Sunday would be saved; on Tuesday all files changed since Sunday would 
be saved--and so on for each succeeding day. This method offers time 
saving over both of the previously described methods since the only files 
that are written to tape each day are those that have been modified or 
entered since the first day of the cycle. And, only two tapesets are needed 
to restore all files (Figure 89.9). 

Story daily backup Topic _Keyword _ 

Basket PRODUCTION Desk _Author RICK _ 

^Output DATA ( TANDEM ) 


tape/out (filename)/(device), [(configuration file)] 
system siie 
tapeset (name) 

select entry'date > 5/05/82 
select last'date > 5/05/85 
save 

Figure 89.9. Data Take to Save All Stories Entered or Changed Since the Start of the Cycle 


Tape Security 

Once files have been transferred to tape,there is still the question of 
protecting the tapes from possible damage or misuse. Ideally,tapes should 
be stored in a fireproof vault some distance from the newspaper. 

TAPE Error Messages 

The following messages may be given while you are using tape. Most 
messages occur immediately following the command entry that generated 
the error. 

“Badly formatted date”— tape cannot decipher the date as you have en¬ 
tered it. 

“Badly formatted number”— tape cannot decipher the number you have 
entered (for length comparison in the path sn command for exam¬ 
ple). 
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“Can’t open a file”—Either the file does not exist or you do not have the 
authority to access it. 

“Case statement error”—There has been a program error. 

“File system i/o error”—There has been a hardware failure. 

“I can’t handle bit fields”—You tried to select or reject a story based on a 
Q-field that is a single bit flag, tape does not allow this. 

“I don’t understand this”—A command or parameter is undecipherable as 
you have entered it. 

“Illegal command”— tape cannot decipher the command as you have 
entered it. 

“Illegal syntax”—The syntax of a select or reject command is incorrect. 

“Invalid parameter string”—You have entered the tape startup parameters 
incorrectly. 

“Invalid time specified”—You have specified an invalid time in a select or 
reject statement. 

“Missing leading quote”—A string constant being compared to a Q-field in 
a select or reject statement must be enclosed in quotes. For 
example film'status = “f.” 

“Missing right parenthesis”—A complete condition in a select or reject 
statement must be enclosed in parentheses. 

“Missing trailing quote”—A string constant being compared to Q-field in a 
select or reject statement must be enclosed in opening quotes. For 
example film'status = “f.” 

“Must be a tape device”—The device specified in the tape startup parame¬ 
ters is not a tape drive. 

“No bit arrays,please”—You tried to select or reject a story based on a 
Q-field that is a single bit flag, tape does not allow this. 

“No key with that path”—You have specified a path for which a key is not 
allowed. 

“No startup message found”— tape did not receive a startup message. Try 
again. 

“No story header found”— tape could not find a story header on the tape 
you are trying to restore. This may indicate a bad tape. 

“No such Q-field name”—The process does not recognize the Q-field 
name you have specified in a select or reject statement. 

“No system specified”—You have not specified a system with the system 
command. 

“No tapeset specified”—The name of the set of stories to be saved or 
restored must be specified with the tapeset command before saving 
or restoring can begin. 

“Not a unique abbreviation"—The abbreviation you entered for a com¬ 
mand is not unique. Enter it with more characters. 

“Quoted string is too long”—You entered a string constant in a select or 
reject statement that is longer than the Q-field to which it is being 
compared. 
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Reel isn’t number 1”—You are attempting to start restore in the middle 
of a set of reels. The process allows you to do this;this message is 
intended only to inform you that it is happening. 


“Restore didn’t find it”—The specified tapeset was not found. 


“System does not exist”—The system specified in the system command 
does not exist. 


“Tape label is bad”—The tape can't be read or it was not written by the 
tape process. 

“Too many select/reject” —A maximum of 10 select/reject state¬ 
ments is allowed. 
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SECTION 90 

TCOPY 

Standard Disk File Name: SSYSTEM.SYSTEM.TCOPY 
Process Revision Level: S0085.E01.000 (002) 


Description 

tcopy is a program used to create a take in the text file and copy output 
text from any file into that take. Parameters supplied when tcopy is run 
specify the destination system and story information. 

Input may be accepted from any file, from a process, or from Sreceive 
when you specify an “out” file name for a process to be referenced by 
tcopy. Typically, tcopy is used for the following purposes: 

1. To copy a report into a take, instead of spooling it for a line printer. 

2. To copy a hardcopy list produced by the index or Dictionary command 
( iCMDl fxlor lCMDl fTI) into a take, instead of spooling it for a line printer. 

3. To copy into takes lists and proofs produced by such utility processes 
as fmod (font modification) and fgen (form generation). 


Execution Syntax 


In all syntax examples in this section, reserved words are shown in upper¬ 
case, even though in actual practice they would probably be typed in 
lowercase. 

Run parameters are shown on multiple lines only for the purposes of 
illustration. In practice they must be entered in a single continuous line. 


TCOPY /in (in file), OUT (out file) [,NAME (proc. name)] [,N0WAIT]/ 
(system), (configuration file name), (story name), (basket name), 
(user name) [, STRIP '(character)'] [, PAD '(10-char, string)'] 


Startup Message 

The parameters between the slashes—/./—may be in any order as 

long as they are separated with commas. The most commonly used pa¬ 
rameters are discussed here. For a complete description of all possible 
parameters, see Section 66, “run/rund.” 

in —The name of the input file from which the text will be received. 


out —The name of the output file to which you wish tcopy error mes¬ 
sages to be written. Normally, this should be specified as So, causing 
messages to be printed on the system console. If you like, specify a 
name of your choosing—such as $s.#john.tcopy— by which the 
error output may be examined in the spooling file with scan process. 


name —A symbolic name that you assign to the tcopy process. As a 
convention, it is suggested that you use your initials (for example, 
Spdq). 


When you execute tcopy to capture output that would normally go to 
your proof location, this process name must also be specified as the 
proof location in your User Profile. 
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routing rgen (or other process) output to a take, this process name 
must be the same as the out file for that process. 

nowait —Specifies that tcopy is to run immediately and be ready for input 
as soon as the startup message is read. When tcopy is executed in 
Command Interpreter, this option prevents the Command Interpreter 
from pausing (suspending and giving a new semicolon prompt) when 
the program is run (if nowait is not specified, the Command Interpret¬ 
er pauses when a program is run). 

TCOPY Parameters 

The tcopy parameters entered following the slashes must be entered in 
the order specified. If a parameter is omitted, the dividing comma must still 
be entered. 

system —The identifier of the system in whose text file the tcopy take is 
to be filed. Must be a single alphabetic character, typically e (editorial) 
or c (advertising). The location of the system in the network is speci¬ 
fied by the configuration file name that follows. 

configuration file name —The name of the configuration file for the site 
in the format: 

$volume. subvolume. CONFIG 

This file name may optionally be preceded by a network node desig¬ 
nator: 

\node. $volume. subvolume. CONFIG 

where “node” is the mnemonic used to designate the site within the 
network. 

story name —The name (12 characters maximum) to give the new take. 
If the name is not unique, it is ignored. If the story name is omitted, the 
story'name header field will contain the take number, as it does 
when you create a take, and you can locate the take in a directory of 
the basket specified in the basket name parameter (see below). 

basket name —The name of the basket to which the take is to be as¬ 
signed. 

user name —The name to be listed in the take header as the original user 
(and author). If this is not a valid user name, you will not be able to 
perform original-user functions on the take, such as changing the 
author or making the story private, read-only, or copies-only. 

strip —(optional) One character, surrounded by opening quotes, may be 
specified to be removed from the end of each text line. If multiple 
occurrences are found, they will all be stripped. 

pad —(optional) A string of up to 10 characters, surrounded by opening 
quotes, to be added to the end of each text line. This is of primary 
interest when the take is to be formatted for output to a phototypeset¬ 
ter. Most commonly, the pad string would contain a single quad left 
command, but it may contain any combination of characters, including 
a styl call or a user event. 

Example: Copying a Report into a Take 

One of the most common applications of tcopy is capturing the output 
of the report generator rgen in a take. The resulting take may be output to 
a phototypesetter. 
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To accomplish this in a data take (Device = data), the tcopy execution 
line is typed immediately preceding the rgen execution line, which is then 
followed by the report specifications. 

The named tcopy process, shown in boldface, is also the ouTput 

location for rgen (user’s name is Frank Jones): 

• 

TCOPY /IN SRECEIVE, OUT $s. #frank.err, NAME Sfj, NOWAIT/ e, 
$volume.subvolume.CONFIG, My Report, frank, frank, pad 'g CD’ 

RGEN /OUT $fj/ e, Svolume.subvolume.CONFIG 
report specifications... 

The link between the two processes is the process name “$fj.” if there 
are any tcopy errors, they will go to tcopy’s out file—#frank.err—and the 
process will be abended. If there are any rgen errors, the report will be 
suppressed and the error messages will go into the tcopy take. 

In the take named “My Report,” the pad string causes a quad left, 
followed by user event #1, to be inserted at the end of each line. The 
insertion of appropriate commands can virtually eliminate the need to edit 
the take before output to a phototypesetter. 

Although it is possible to run rgen in the local system to list records in 
the header file of a remote system, this is strongly discouraged due to 
normally slow transmission speeds over the telephone. You are advised to 
run rgen in the remote system (by signing on to that system), copy the 
report output into a take in that system’s text file, and then use the 
Transmit Command ( IcmdI □ [t] to transmit the take back to your local 
system. 


Example: Creating a TCOPY “Obey” Take 

Obey takes are takes that contain program run commands, startup 
messages and process parameters. Such a take may be obeyed with the 
obey command (or o) in Sll Command Interpreter: 

; o (story name) 

The text of the take is simply inserted in the command stream. This saves 
you from having to keyboard the same command line each time you want it 
to be executed. 

Another way of making use of the obey take is to output it. This is the 
fastest way of creating a tcopy process for this application (capturing the 
output of a user command). In the take header, the Output Device must be 
specified as data and the location as tandem. Enter the following tcopy 
parameters as text: 

TCOPY /IN SRECEIVE, NAME $mjb\ NOWAIT, OUT $0/ e 2 , 

Svolume.subvolume.CONFIG 3 , 4 , marvin 5 , marvin 6 , pad 'g ’ 7 

This must be typed as one continuous command line. Turn wordwrap off 
and do not type a IreturnI . 

1 Type your initials as the process name (or any name you like, this is just a 
convention). The same process name will be used each time you execute 
TCOPY. 

2 Type the designator of the system to which you are signed on. 

3 Enter the system’s configuration file name. 

4 No story name is entered. All takes created by tcopy will have system- 
assigned take numbers as story names. This will enable you to output this 
take whenever you need it without having to edit it. 
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5 Enter the name of your personal basket or other basket to which you wish 
the takes assigned. 


5 Type your user name. 


7 The quad left command causes a return on the vdt, but this is not 
permissible on the command line (the final quote will not be found). Move 
the cursor back up to the end of the line and delete the return before 
typing the final opening quote character. 

The obey take is complete. Double check the output device and location 
in the header and give the take a short, easy-to-remember name before 
filing it. You will be able to output this take repeatedly without changing it. 


Using TCOPY with Utility Processes 
That Produce Proofs and Lists 


There are two types of utility processes in System/55: 

1. Edit Utilities. These are processes that operate similarly to the text 
editing software because their applications are like editing. They have 
their own user commands that are executed with the IcmdI key, and 
they supply and process prompts identically to normal editing software. 
Examples of such utilities are fgen and spedit. Both of these process¬ 
es have hardcopy proof commands. The proofs are sent to the user’s 
Proof Location. 


2. Command-Line Utilities. These processes operate more like Com¬ 
mand Interpreter. Each process uses its own prompt character, which 
serves to identify it when the user pauses from one executing process 
to another. Almost every cqmmand-line utility process has its own 
lexicon of commands, each of which is typed on the command line in its 
own prescribed syntax. Examples of this kind of utility process are 
fmod, schedset, and scan. Many of these processes produce lists 
that are normally displayed on the user’s vdt. 


Copying a Proof Produced by an 
Edit Utility Process into a Take 

Edit utility processes that have proof commands (fgen, spedit) queue 
all proofs requested by the user until the user exits the process. At that 
time all proofs (each one beginning a new page) are dumped to the user’s 
Proof Location as a single unit. The result is identical to having entered 
Icmdi [p| to produce that collective proof. 

To copy the proofs into a take, follow the steps under the heading 
“Copying a List Produced by a User Command Into a Take,” with the 
following exceptions: 

In step 3, you may obey the tcopy obey take in Command Interpreter if 
that is more convenient. 


As in step 4, execute the utility as you would normally, producing proofs 
along the way. Then exit. Your new take will be waiting in your personal 
basket. 
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Copying a List Produced by a 
Command-Line Utility Process Into a Take 


Many command-line utility processes have one or more list commands 
that list data on the user's vdt. One process that produces report-like lists 
is fmod, the device and font modification utility. 


In order to collect this information in a take, we obey the same tcopy 
obey take in SI I Command Interpreter (in this example the take is named 
“my tcopy”). Then we execute the process with a start-up message and 
specify all commands on one command line. As the out file we specify the 
named tcopy process. Note that command-line utilities do not send output 
to your Proof Location. Except for the fact that we are doing this in Sll 
Command Interpreter, the method is identical to the one used for copying 
reports produced by rgen into takes. 


Follow these steps: 

1. Enter IcmdI Q] to execute Sll Command Interpreter. 


2. Obey your tcopy obey take: 


;o my tcopy 

;tcopy /in $receive, name Smjb, nowait, out $0/ e, 

Svolume. subvolume.config,font list,marvin.marvin, pad 'g ' 

o is a unique abbreviation of the Obey command. The contents of the 
obey take are printed as they are executed. The tcopy process named 
“Smjb” is now running and waiting for input. 


3. 


Execute the utility (in this case fmod), naming the tcopy process as 
the out file: 


;fmod /out $mjb/ device aps; 


list font corona 


Information for device aps, font Corona, has been listed and placed in 
the tcopy take. For clarity, the fmod commands are not abbreviated. 


This procedure is the equivalent of entering the same command lines in 
a data take (Device = data, Location = tandem) and outputting the take. 
The text of the take would be: 


tcopy /in Sreceive, name Smjb, nowait, out SO/ e, Svolume. 
subvolume.config, font list, marvin, marvin, pad ’ g 1 
fmod /out Smjb,/ device aps; list all 


The list is in the new take named “font list.” 
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SECTION 91 

TDUMP 

Standard Disk File Name: 5SYSTEM.SYSTEM.TDUMP 
Process Revision Level: S0225.E01.000 (002) 

Description 

tdump converts binary character input from a specified take to hexa¬ 
decimal and graphic characters and outputs it to a specified file, tdump 
cannot be used to process stories flagged private. 

Execution Syntax 

tdump can be executed from Sll Command Interpreter. At the semico¬ 
lon prompt enter tdump followed by the desired parameters. For example: 

;tdump/in Ssystem.sysdata.config, out $s./tdump/e, tdump,5 

Ssystem.sysdata.config —the configuration file name. 

$s.#tdump —the output file name. If an output file is not specified, the 
results are displayed on the terminal from which the program is 
executed. 

e —the system identifier. In this case “e,” editorial. 

tdump —the name of the story to dump. If the first character is #, the 
characters are assumed to be the story number. 

5—the number of records to dump. If the number of records is not speci¬ 
fied, tdump defaults to 2. 

% 

Delimiting Character 

The character following the system identifier is the delimiting character. 
If a comma is used in the story name, the delimiting character can be 
changed to any other special character. 
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Example 

TDUMP gives both a hexadecimal and character listing of any story 
stored in the system. The hexadecimal is given on the top line with up to 3 
characters of graphic on the line below (Figure 91.1). Only the first two 
records will be dumped unless you specify otherwise. 
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Figure 91.1. tdump listing 



TDUMP Error Messages 

The following messages may be given while you are using tdump. Most 

messages occur immediately following the command entry that generated 

the error. 

“Cannot dump personal stories”—Stories flagged private cannot be ac¬ 
cessed with tdump. 

“case statement index out of range”—Contact your Sll System Engineer. M s 

“Configuration entry not found”—The system configuration file is incorrect 
or incomplete. Contact your Sll System Engineer. 

“Fatal i/o error in [filename]"—There has been a hardware failure, the disk 
drive is not working properly, the file is full, etc. 

“Invalid record count”—You may have entered the comma following the 
story name without specifying the number of records. 

“Invalid story number”—The name of the story to dump started with “#” 
but was followed by non-numeric characters. A story number was 
expected. 

“Missing delimiter”—You have omitted the delimiting character following 
the system identifier. 

“Missing story name/number”—You have not specified a story to be 
dumped. 

“Missing system identifier”—You have not entered a system identifier. 

“No startup message found”— tdump did not receive the startup message 
it expected from the Sll Command Interpreter. Try executing tdump 
again. If you get this message a second time, contact your Sll System 
Engineer. 
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“No such story”—The story you have specified to be dumped is not found. 

“Number of records dumped”—This message is given after tdump has 
completed. It does not indicate an error. 

“open failed for”—Either the file does not exist or you do not have the 
authority to access it. 
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SECTION 92 

VDTSTATS 

Standard Disk File Name: SSYSTEM.SYSTEM.VDTSTATS 
Process Revision Level: S0258.E03.000 (000) 

Description 

The vdtstats process provides statistics on directory requests record¬ 
ed in the vdt statistics file by gstat (see Section 19). It creates a file in 
which the output is initially saved, and subsequently updated, with each 
run of the program. The output of a particular run reflects the accumulated 
data from this save file, if any exist. 

At startup time, vdtstat opens the following files: 

Statistics file—This is a data file containing vdt statistics (the “in” file 
specified in the run line). The vdt statistics file is a circular file holding 
about a day’s worth of statistics (depending greatly on system activi¬ 
ty). The program uses a time stamp to identify records that have been 
previously read. There is no chance that the same data will be used 
repeatedly. 

List file—The file containing the list name and Q-fields used for that list 
(configuration file, record type 11). 

vstat save file— Sdefault vol.default subvol.vstatsav If this file 
doesn't exist, it is created and used to save the results from current 
processing. If this file exists (assumed by virtue of a previous run of 
this process) the data is read and updated by the current process. 

When executed, vdtstats attempts to read “old” data from the vstat 
save file. If it cannot do so, it assumes that the file doesn’t exist and 
creates the file. If it successfully reads the file, the current output will reflect 
previous results collected by the process. 

Next, vdtstats reads data from the vdt statistics file, and determines 
whether the request is a valid directory request (defined as any directory 
command). The process outputs a summary that includes the number of 
requests using a particular path/list name, and how many of those re¬ 
quests used the extract file. 

The list name of a valid request is used to key into the list file and the 
Q-fields associated with that list are saved, vdtstats outputs a summary 
that includes the count of each Q-field used with a single path, and which 
group of fields taken together would satisfy most requests using that path. 

Finally, the vstat save file is updated. 
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Execution Syntax 

From Sll command interpreter, enter the vdtstats run command in the 
following format: 

run sii.vdtstats / in (input file) [,out output file,run options ] 

/ (system name) 

Parameters in square brackets “[]” are optional; defaults are assumed 
for each parameter omitted. 

input file— the name of the file containing the vdt statistics. 

output file —the name of the file where the statistical summary is written. 
Omitting this parameter writes the results to the screen. 

NOTE: It may take 15 minutes or more for this process to run to 
completion. 

system name —the logical name of the system (for example, she) that the 
program is being run against. 

Typical run commands: 

run sii. vdtstats/ in $data. svsdata. siistats, out $s. #s.Ip, no¬ 
wait/ siie 

or 

run sii.vdtstats/ in Sdata.sysdata.siistats/ siie 



Example 




% Directory 

% Path Requests 

Path 

Count 

Requests 

Using Extract 

BA 

787 

%80 

%76 

DE 

104 

10 

0 


Figure 92.1. vdtstats Output 



COUNT— For all recorded directory requests, this is the frequency the listed 
path was used. 

% directory requests —The ratio of directory requests using the listed 
path to total directory requests. 

% path requests using extract— The ratio of requests for the listed 
path using the extract to the total number of directory requests using 
the listed path. 

The boldface fields in Figure 92.2 are in the header extract definition 
record for path “basket” in Section 61 of this manual (see Figure 61.3). 
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Field Usage 

Dir Requests Satisfied 

Path Field Name 

Count 

Per Path 

With Addition of Field 

BA LINES 

746 

%94 

%0 

STORY NAME 

731 

92 

0 

GUIDE 

726 

92 

0 

FILM STATUS 

679 

86 

77 

AUTHOR 

103 

13 

77 

ENTRY DATE 

92 

11 

77 

LAST DATE 

71 

9 

77 

BASKET NAME 

70 

8 

77 

ENTRY TIME 

56 

7 

77 

KEYWORD 

56 

7 

77 

PREVIOUS USER 

56 

7 

77 

PRIORITY 

55 

6 

77 

LINE NUMBER 

50 

6 

77 

TOPIC 

50 

6 

84 

XMIT DATE 

36 

4 

88 


Figure 92.2. vdtstats Output 

count —The number of times the data was retrieved (for a path/list) using 
the extract file. 


field usage per path— The ratio of the frequency the field is used by the 
listed path to directory requests using the listed path. 

dir requests satisfied with addition of field —The percentage of 
directory requests using the listed path that were satisfied with the 
use of all fields up to and including the current field. 

In Figure 92.2, field lines was used 746 times on path ba. That is, there 
were 746 requests using lists in which lines was included; 94% of the 
requests on path ba used Q-field lines. 

The listing also shows that 77% of the directory requests on path ba are 
satisfied with the first four fields. This does not mean that 77% of directory 
requests use the extract file. It does mean that lists made up of these four 
fields are the most frequently used on path ba. Therefore, it would make 
sense to include these four fields in the extract file if the percentage of 
directory requests using this path exceeds 30-40 percent. By looking in the 
Header Extract Definition Record for Basket we can verify whether these 
fields are included. 

In addition, this listing shows that if o-fields author, last'date, bas- 
ket"name, previous'user, priority and line'number were included in 
the extract file, the percentage of directory requests satisfied and using the 
extract would rise to 84%. 

This example indicates that a decision about whether to include a Q-field 
in the extract file is not automatic. If there are many directory requests 
using a particular path, then those fields most frequently used should be 
included in the extract for that path. For less frequently used paths, it 
makes little difference whether a request uses the extract or the header 
file. Those Q-fields should not be included in the extract for that path. 
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SECTION 93 

VDTGEN 


Standard Disk File Name: SSVSTEM.SII.VDTGEN 
Process Revision Level: S0045.E01.001 (001) 


Description 

vdtgen is useful for making changes to the configuration file records for 
vcontrol processes during initial installation, hardware upgrades or sys¬ 
tem tuning. 


CAUTION 

Since this utility writes (and deletes) records in the 
configuration file, it should be secured so that only 
authorized and knowledgeable personnel can exe¬ 
cute it 





Execution Syntax 

vdtgen can be executed from SI I Command Interpreter. At the semi¬ 
colon prompt, enter the program file name and the configuration file name. 
For example: 

;run sii.vdtgen/ out Ssystem.sysdata.config/ 


Example 


The sequence of commands in Figure 93.1 would add 16 new editorial 
vcontrol records for Coyote terminals for logical device $F5, balancing 
their primary and alternate cpus evenly across all available opus (exclud¬ 
ing cpu 3), and create the appropriately named vpend files for them. 


;run sii.vdtgen/ out Ssystem.sysdata.config/ 
Delete all the old VDT records first 0 
Exclude CPU 0 3 

Redistribute existing VDT processes 0 
Gather VDT stats by VCU TCU/XTM FTM? 

Create missing VPEND files? 

VPEND volume subvolume 0 Sdata.vpend 
System? e 


Figure 93.1. vdtgen Commands to Add vcontrol Records (partial) 
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What kind of device (VCU/TCU/XTM/FTM)? ftm 


Part/Page/Edition? 


FTM name? $f5 


System? 

% 

VPEND volume/subvolume? 



Figure 93.1. vdtgen Commands to Add vcontrol Records (concluded) 



SECTION 94 

VUP 

Standard Disk File Name: SSYSTEM.SYSTEM.VUP 
Process Revision Level: S0087.E01.002 (006) 

Description 

vup is a general-purpose vdt process with six available functions: 

stop —Stops a vdt control process (econtrol [editorial], ccontrol [ad¬ 
vertising]). This function places the vdt in a signed-off state (the 
process is dormant). The vdt may not be signed on again until the 
process is restarted with the start function. 

kill —Stop a vdt control process. It is restarted by zeus. 

start —Starts a vdt control process (following system maintenance) that 
was stopped with the stop function. 

send— Sends a message to a vdt control process (a physical vdt). The 
message is displayed on the status line. 

signon —Instructs the vdt process to sign on the user found in the vup 
sign-on information file (vup info). Used primarily during initial sys¬ 
tem setup. 

execute —Instructs the vdt process to execute a gdk. The gdk and the 
name of its associated glossary are found in the vup sign-on informa¬ 
tion file (vup info). Used primarily during initial system setup. 

Each of the six vup functions may be performed for: 

1. a group of processes (a vdt stop group, representing physical termi¬ 
nals); 

2. a single process; 

3. all processes running on a specified cpu; 

4. all processes running on a logical system; 

5. for all processes with a specified program file name; or 

6. all processes running in the wrong cpu. (This is a group [icpu] of vdt 
processes that are supposed to be running in one processor, but are in 
fact running in another processor. It is used for load balancing after a 
processor is reloaded and is being brought back into the system.) 

Defining VDT Stop Groups 

Normally it is most convenient to perform vup functions by referencing a 
group of processes that are running against specific vdts in specific 
locations. The process in the host computer is said to be running "against” 
the terminal, meaning that the process supplies the terminal with its “intelli¬ 
gence” for database interaction. 
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vdt groups are defined by creating a record specifying each pro¬ 
cess/group relationship. The record uses the structure vdt'stop. (See 
Index of Record Structures [S55-007] for instructions on how to determine 
the file name to use for forms and lists.) 

The record form looks like this: 

Process name _ Group name _ 

Each process name must be defined in the configuration file. Here is a 
typical process name: $F4i 2 . 

A process name begins with a dollar sign ($). The first two characters 
following the dollar sign—a letter (a-z) and a number (0-9) —represent the 
terminal controller. This scheme permits up to 26 alphabetic groups with 
up to 10 control units per group. The last two digits represent the board 
position in the control unit. Therefore, the above process is running against 
terminal number 12 in control unit F4. This name is always used to refer¬ 
ence the process ($F4i2) running against the physical terminal 
($F4.#li 2), both in the configuration file and by vup. 

You assign the group name. There may be as many groups as you like, 
and a process may belong to any number of groups. It is most efficient to 
create new stop group records from an index. Point the cursor at an 
existing record and enter IcmdI Q [fJ. A blank record of the same type wiil 
be displayed. You must supply both the process name and the group 
name. Consider defining vdt stop groups in one of the following ways. 

1. By control unit. This is required for successful operation. Define stop 
groups by the controller to which the terminals are connected, naming 
the control units as they are specified in the process names--Fi, F2, F3, 
etc. (a System/55 convention). This will enable you to stop, start, and 
send messages to all terminals on a single terminal controller. 

2. By physical controller location. If the control units are divided into 
several locations in the newspaper, perhaps outside of the main com¬ 
puter room, you will want to define the units in each location as a group. 
If your system supports one or more remote controllers at a bureau 
location, that bureau would be a group. Being able to stop these units 
quickly will enable you to perform swift maintenance on them with a 
minimum of discomfort to users. 

3. By physical VDT location. This is less often a need. If construction or 
other building maintenance is being performed in an area of the news¬ 
paper that would prevent users, for electrical or other reasons, from 
safely continuing with their work, you may wish to define those vdts as 
a group to be able to stop them easily and quickly. 

Note that it is unnecessary to define groups by vdt application—classi¬ 
fied or editorial—since vup also provides the means of stopping vdts by 
system or program file name. Moreover, any vdt may be signed on to any 
system and a controller rnay be split between editorial and classified. A list 
of vdt stop records should be defined for your system so you may list them 
on a vdt or on hardcopy (by requesting a proof of the list). The list is sorted 
first by group name, then by process name. 
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by 


To execute vup, start Sll Command Interpreter and enter vup followed 
the startup parameters and the desired function (Figure 94.1). 


; vup 

VUP /IN (configuration file name), OUT (list file name)/ 
[(delay)] 

(function) 

(GROUP (name)) (PROC (name)) (CPU (number)) 

(SYSTEM (id)) (PROG (program filename)) 

((a message)) 


Figure 94.1. Starting vup 


It is necessary to specify the configuration file name as the in file if you 
are executing the process from a terminal not manufactured by Sll (a 
terminal not running under a vcontrol process) or from Tandem Com¬ 
mand Interpreter (comint), and the out list file name is required only if you 
wish messages from the process to be printed on a device other than the 
executing vdt. 

Under normal conditions, therefore, these parameters are not required. 


vup is executed by typing a function keyword (send, stop, kill, start, 
signon, or execute), followed by a modifier keyword (group, proc, cpu, 
system prog or icpu), followed by a parameter appropriate to the modifi¬ 
er (name, number, id), followed, as appropriate, by a message. When vup 
is entered in response to the Command Interpreter prompt with no param¬ 
eters or with erroneous parameters, the process provides help as shown in 
Figure 94.2. 


VUP - VDT Utility Process; 6/09/82 13:17:59 
To run it: 

VUP /in (config file), out (list file)/ 

[(delay)] 

SEND, STOP, KILL, START, SIGNON,EXECUTE 
(GROUP (name)) (PROC (name)) (CPU (number)) 

(SYSTEM (id)) (PROG (program file name)) 

((a message)) 

The optional (delay) parameter specifies the number 

of seconds to delay between messages. Note that the PARENTHESES 

ARE REQUIRED. 

If SEND is specified and no message is entered, a canned 
message is sent to all VDTs informing the various users 
that their VDTs will be stopped shortly. 

This utility process allows a user to issue a Stop, Kill, Start, 
Send, Signon, or Execute to a specified group of VDT control pro¬ 
cesses. 

A group can be specified as: 

1. A group of VCONTROL processes as described in the VDT STOP da¬ 
ta file using the keyword GROUP. 


Figure 94.2. Help Provided by the vup Process (partial) 
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2. A single named process (e.g., SB405) using the keyword PROC. 

3. All VCONTROL processes running in a particular CPU using the 
keyword CPU. 

4. All VCONTROL processes running on a particular system(e.g., 
Classified, system 'C') using the keyword SYSTEM. 

5. A particular program file name (e.g., osii. econtrol)using the 
keyword PROG. 

6. All processes that are SUPPOSED to be running in a given CPU 
but are ACTUALLY running in some other CPU using the keyword 
I CPU. 

If STOP is specified and a message is entered after the 
VDT process group name, that message is broadcast to all 
VDT control processes in the group, else a canned message 
is sent informing users that the VDT is stopped for 
system maintenance. 

The KILL function first stops the VDTs in the group, 
ensuring that no data is lost. 

The SIGNON function signs on the user(s) listed in the VUP 
information file under the process name(s) specified. 

If that user has a password, the sign-on fails, unknown to 
VUP. 

The EXECUTE function requests the VCONTROL process to execute 
the GDK found in the VUP info record associated with that 
process. 

This process does not guarantee that the function sent with the 
message is actually acted on by the control process; it 
only sends the message. 

Messages are displayed on the user's terminal, even if 
the user has executed the DO NOT DISTURB function, and 
are not entered into the user's message file. 

Figure 94.2. Help Provided by the vup Process (concluded) 


SEND Function 

This function is used for sending a message to vdts as represented by 
their process names. This, like all functions of vup, applies to a vdt in a 
specific location, not to the individual who may be signed on to it. It should 
not be confused with the vcontrol Message command— IcmdI [~m[ 
—which sends messages to users and groups of users wherever they 
may be signed on. 

The normal application of this function is to warn the users of vdts of 
impending system maintenance or of a new download of the terminal 
controller; i.e., an upcoming execution of the stop function: 

; vup[..send..group f [4 l.VDTs[.. will : ___stop..for..maintenance 1-lj.30..a. m. 

This function may also be used as desired for non-hardware-related pur¬ 
poses. In normal practice the message is addressed to a vdt stop group 
(see “Defining vdt Stop Groups,” above), in this case “f4.” The message is 
displayed in the bright attribute on the status lines of all vdts in the group: 
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VDTs will stop for maintenance 1-1:30 a.m. (^ORIGINATOR*) 

A confirmation is printed on the executing vdt: 

nnn processes in group, nnn messages sent 

The message plus the name of the sender (a user name, or system if the 
program is not being rdn from Sll Command Interpreter) must be able to fit 
on the status line of the vdt. The sender is always identified and, if 
necessary, the message is truncated to fit with the originator name. If the 
user has a maximum-length name of 12 characters, the message may be 
47 characters long. If the sender’s name is shorter, the message may be 
proportionately longer. 

A message may also be sent to an individual process: 

; vup send proc Sf 211A Jiew controller board__is j)n_ its way 

or to all vdt control processes running on a specified cpu (send cpu 3), or 
assigned to a specified logical system (send system e), or running on a 
particular program file name (send prog osii.econtrol). 

This latter instance is applicable in advance of loading a new version of 
a vdt control program. 

If the send function is specified without a message, a standard “canned” 
message is sent: 

VDTs will be stopped shortly (^ORIGINATOR*) 

This message is meant to save time when you are in a hurry. It is best to 
use the send function with your own message letting users know more 
specifically when vdts wiil be stopped. 

When vup is executed on a vdt running under a vcontrol process, 
that vdt’s process is the “ancestor" of the vup process. If the ancestor 
happens to be encompassed in the stop execution (as part of a group, 
cpu, system, or program file name), the ancestor process is excluded and 
is not stopped. 

To stop a group of terminals that includes your own, you may, therefore, 
execute vup from your own terminal with no difficulty. If, depending on the 
reason for, and duration of the stop, you need to stop your own vdt, that 
must be done from another terminal or a system console. 

STOP Function 

After first filing a take or record displayed on a vdt (or stopping a utility 
process the user is running), the stop function suspends the specified 
control process in the host cpu until it is restarted with the start function. 
It follows the same format as the send function, and you may include an 
original message if desired, but the name of the originator is not broadcast 
as it is with the send function. 

If a message is not included, a canned message is broadcast to the 
specified processes: 

YT)T stopped for system maintenance 

In addition to stopping vdts in groups, a single failing vdt (terminal or 
controller board) may be stopped until the problem can be corrected. You 
can also stop processes running on a cpu when that processor must be 
put down for maintenance, and by system id or by program file name when 
it is time to load new software. 

Note: When you stop a terminal or group of terminals, the terminal from 
which you execute the stop function is not stopped. 
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Consideration for System Users 

When stopping vdts it is important to keep users informed of your 
intentions and to have respect for their work toads. When users know in 
advance that a vcu or a system is to be taken down at a particular time or 
for a specified period, they can adjust their schedules to get their work 
done. Try to avoid stoppages during heavy production periods. 

Plan maintenance periods in advance. If vdts must be stopped for more 
than 5 minutes, begin advising users with the send function some time in 
advance so that they can prepare for it. Repeat the message periodically; 
a user signed on to a terminal ten minutes before the stoppage may not be 
the same person who was signed on when you first sent the message. 

KILL Function 

This function specified identically to the stop function (also with mes¬ 
sage capability). It files all displayed data automatically so that none is lost 
and stops the process. The process will be restarted by zeus. 

START Function 

Following a stoppage initiated with the stop function, vdts are returned 
to a normal signed-off state with this function. The start function is 
executed identically to the other functions, except that a message may not 
be included. 

Note: When a vup function sending a message (send, stop or kill) is 
executed on a terminal (or from a process) not running under a 
vcontrol process (e.g., a console typer) the originator of the mes¬ 
sage, as printed on the recipient vdts is always “‘system*.” 

When executed through the S?l Command Interpreter the originator 
is always the name of the signed-on user—for example, ‘“randy*.” 

SIGNON and EXECUTE Functions 

The signon and execute functions use the vup info list and form. That 
form looks like this: 

Process _ User _ 

Glossary _ GDK _ Type 

signon instructs the vdt process to sign on the user found in the vup 
sign-on information file (vup info). 

execute instructs the vdt process to execute a gdk. The gdk and the 
name of its associated glossary are found in the vup sign-on information 
file (vup info). These functions are intended primarily for use during 
system staging to sign on users and start gdks for system performance 
analysis. 

The syntax of the execute function is as follows: 

vup /[in (config file name)] [, out (list file name)]/ 
execute [((GDK name))] (group specifier) 

for example 

; vup execute (1) system e 

would execute gdk i on system 3 

;vup execute system e 

will execute the gdk found in the vup info record of each vdt on system e 
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VUP Error Messages 

Note: Many of the error messages are followed by a standard system 
error number to make the error more specific. For the meanings 
of the error numbers, see Appendix A or consult the Tandem/16 
Software Pocket Reference Manual (Tandem Product No. 
ti 6/8031). Or, in Sll Command Interpreter, enter “error” followed 
by the number to display an explanation. 

“Can’t communicate with (process name)”—The host cannot communi¬ 
cate with the named process. 


“Can’t find system description file in Config”—In connection with the sys¬ 
tem modifier, the file defining the system cannot be located in the 
configuration file. 

“Can’t find vdt stop file in Config”—You have specified for a function to be 
modified by a group name. However, the vdt Stop file containing the 
group definition records cannot be located in the configuration file. 

“Can't open config file, error nnn”—The configuration file cannot be 
opened. 

“Can't open (file name), error nnn”—Either the file does not exist or you do 
not have the authority to access it. 


“Can’t open (program file name), error nnn”—Either the file does not exist 
or you do not have the authority to access it. 





in file doesn't look like config, error nnn"—The in file you’ve specified 
must be a valid configuration file. Even though the syntax of the file 
name may be correct, it doesn’t by its characteristics appear to be the 
right kind of file. 


“Info file entry not found for (process)”—No entry was found in the vup 
info file for the indicated process. After logging this message vup will 
automatically go on to the next process. 

“Invalid cpu number”—The cpu number specified with the cpu modifier 
does not exist or there are no vdt control processes running on that 

CPU. 


“Invalid function specified"—The function keyword you have specified is 
not valid. The four functions are: send, stop, start, and kill. They 
may not be abbreviated. 

“Invalid grouping specified”—The modifier keyword you have specified is 
not valid. The permitted modifiers are: group, proc, cpu, system, 
and prog. They may not be abbreviated. 


“Invalid process name”—The process name specified with the proc modi¬ 
fier is not a legitimate process name as specified in the configuration 
file, or one of the processes specified in a vdt stop group record is 
invalid. (It can’t be determined to be invalid until you attempt to use it 
with vup.) 


“Invalid program file name”—The program file name specified with the 
prog modifier does not conform to the proper filename syntax. 


“Invalid system, error nnn”—The system id specified with the system 
modifier is invalid (probably a typo). 
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“0 process in group”—0 messages sent 

“No one signed on to (process name)’’— A vdt control process to which 
you’ve sent a message with the send function (not with stop or kill) 
does not have a signed-on user and therefore has not displayed the 
message. 

“(process name) is not stopped”—You have attempted to start a vdt 
control process that has never been stopped. 





94.8 


Utilities 


XTM 


SECTION 95 

XTM 

Standard Disk File Name: SSYSTEM.SYSTEM.XTM 
Process Revision Level : S0203.E06.001 (000) 

Description 

XTM is a utility used on tns i systems for temporary (in cpu memory) 
modification of data communication parameters of Sll’s xtms. It also re¬ 
ports statistics on communications between xtms and the cpus. (For tns 
n-based System/55s, see ftm, Section 72.) 


CAUTION 

Improper use of this utility can cause xftms to fail 
to communicate and can also cause cpu halts. 
Secure accordingly 


Execution Syntax 


To run xtm, start Sll Command Interpreter and enter xtm in response to 
the semicolon prompt. 


; xtm 

Figure 95.1. Starting Process xtm 


Available Commands (by function) 

fc —Interactively edit last command 
help [command] —Print long command descriptions 
exit (or eof!) —Terminate execution of program 
debug —Debug xtmprocess 

Device/Line Selection 

device (name)—specify device to modify 
line (line) [, (line)]—Specify line or range of lines 
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Data Communications Parameters 

show —Show terminal parameters 
store —Store new parameters 
baud (rate)—Set baud rate 
RS232 —Use RS232 levels 
RS422 —Use RS422 levels 
direct —Direct connection to vdt 
modem —Switched connection to vdt 

Statistics 

trace (modifier)—i/o trace control 
listopens (subdevice)List openers of a subdevice 
stats —Display line statistics 
clear —Clear line statistics 

Detailed Command Explanations 
(listed alphabetically) 


BAUD 

The baud command changes the desired baud rate. The command has 
no effect until a store command is given. The rate given must be one of: 
45, 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 4800, 9600, 
19200, or 38400 baud. 

CLEAR 

The clear command is used to reset the line statistics kept by xtmpro- 
cess. 

DEBUG 

The debug command is used to debug xtmprocess. It should only be 
used by Sll personnel who know what they are doing. Used without 
forethought, this command can cause a processor halt. You must be 
signed on to super.super to execute this command. 

DEVICE 

The device command specifies the name of the device to befrnodified. 
By default all lines are selected (see the line command). 

DIRECT 

The direct command is used to specify that the vdt is connected 
directly to the xtm line. 

LINE 

The line command is used to select a single line or a range of lines to 
be modified by subsequent store and/or trace commands. 
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LISTOPENS 

The listopens command displays the openers of the specified subde¬ 
vice. 

MODEM 

The modem command is used to specify that the vdt is connected 
through a RS232 modem to the xtm line. 

RS232 

The RS232 command changes the line to use RS232 voltage levels. The 
command has no effect until a store command is given. 

RS422 

The RS422 command changes the line to use RS422 voltage levels. The 
command has no effect until a store command is given. 

SHOW 

The show command lists the configuration parameters for the first line 
in the set of selected lines (see the line command). 

STATS 

The stats command is used to display the line statistics kept by 

XTMPROCESS. 

STORE 

The store command stores the modified parameters for the selected 
lines (see the line command). 

TRACE 

The trace command allows you to enable and/or disable the 1/0 trace 
feature of xtmprocess. The various modifiers that are supported are: 

off —Disable tracing 

packet —Trace incoming/outbound packets 
event —Trace packets and driver events 
eio —Trace eio commands and interrupts 
all— Trace everything 
dump —Dump the current trace table 
disk —Dump the trace table to disk 
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Examples 


Check Statistics for XTM SX2 


>dev SX2 

BAUD38400 RS422 DIRECT 

>stats 

Input 

Output 

Data transfers 

8074 

8914 

Data bytes 

113013 

617070 

Data packets 

8358 

10449 

Total packets 

54793 

66144 

Continued packets 

4 

1567 

Discarded/resent 

1 

0 

EIO instructions 

540019 


INTR awakes 

121390 


Resent bit map 

0000 


Max. sequenced packets 

36 


Max. resident memory 

4692 


> 




Figure 95.2. Commands to Check Statistics for xtm $X2 



Trace Packets Sent to/from XTM SX4 
and Dump on Screen 


>device 3X4 


>trace packet 
>trace dump 

08/19/85 13:32:26.77 Line 03/0 
0000/0000, P# = 15 
08/19/85 13:32:26.77 Line 03/0 
0000/0000, DATA = 00000000 
08/19/85 13:32:15.09 Line 12/0 
08/19/85 13:32:15.09 Line 12/0 
08/19/85 13:32:15.09 Line 12/0 
0000/0000, P# = 15 
08/19/85 13:32:15.09 Line 12/0 


PACKET IN. SIZE = 04/000, 

PACKET OUT. SIZE = 04/000, 

EVENT. STATE = 2. SUBSTATE 
EIO. PC = 7(010444. COMMAND 
PACKET IN. SIZE = 04/000, 

EIO. PC = 7 C 004460. COMMAND 


FUNC = 02. C/S/A = 0/0/0, WORD0/1 = 
FUNC = 01. C/S/A = 0/0/0. WORDO/1 = 
= C000. EVENT = 3 

= 2DBC. PARM = 000F. DEVSTAT = 0000 
FUNC = 02. C/S/A = 0/0/0. WORDO/1 = 

= 33BC. PARM = 000F. DEVSTAT = 0200 


>trace off 

> 


Figure 95.3. trace packets sent to.from xtm Sx4 and Dump on Screen 



Check Current Parameters for XTM SX5 and List 
Processes That Have Given Coyote Channel Open 


>device SX5 
BAUD38400 RS422 DIRECT 
>listopens #R03 
OCB 01. PPID = SX503 


Figure 95.4. Check Current Parameters for xtm Sxs and List Processes That Have Given Coyote Channel Open 
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Change Parameters for All Channels of XTM SX1 


>device SX1BAUD38400 RS422 DIRECT 

>baud 1200 

>modem 

>RS232 

>store 


Figure 95.5. Change Parameters for Ail Channels of xftm $xi 
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SECTION 96 

Introduction to System 
Management Topics 

The sections that follow contain information about many System Man¬ 
agement topics. 
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SECTION 97 

Defining Tandem Security 

This section covers the application of Tandem security to System/55 
and makes recommendations for its use. 

Tandem security is independent of any systems that may have been 
defined at your site. Satisfying the requirements of Tandem security in¬ 
volves two basic tasks: 

1. Defining Tandem user ids for each node of the network (if applicable), 
together with local and remote passwords; and 

2. Securing certain files that are critical to system operation. 

Tandem user ids may be used in the following ways to gain access to 
the system: 

• The System/55 User Profile contains fields called tandem'group and 
tandem'user. These fields show the Tandem group/user last used by 
the econtrol or ccontrol user. The Tandem user name is checked 
when executing programs and is called the default Tandem user. 

• Each user can have authority to run a command interpreter or may, 
through schedset, access certain command interpreter programs. 
When a command interpreter is started with either method, the default 
Tandem user is used. 

• Through the Sll Command Interpreter, a user may execute the Tandem 
Command Interpreter (comint) and logon as his assigned Tandem user: 

[CMDl fTI ... 

;comint 

: iP.gon-.sii..super 


The Tandem Command Interpreter is used to: 

• logon directly as a Tandem user to a non-editing console terminal 

• change the default volume and subvolume for a user 

• add, delete, or list Tandem users 

Defining Tandem User IDs 

In the sense that System/55 uses them, Tandem User ids can be 
thought of as being “accounts”—(group id), (user id). Tandem “users” do 
not represent individual persons (although they can for data processing 
purposes), but rather account numbers used by a number of individual Sll 
users to gain access to system files and processes. A user’s Tandem 
account number is recorded in his user record as read-only in the Q-fields 
tandem'group and tandem'user. 
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These fields may be included in User Profile and User Defaults forms 
and in lists of users (see System/55 Index of Record Structures [S55-007]; 
Section A-2 “Q-Field File;” System/55 Editorial Manager's Manual [S55- 
010 ], Section A-2, “User Definition”). 

System/55 uses the four standard classes of Tandem system user. 
They are significant in their (group ids) and (user ids) as follows: 

(group id) = 255, (user id) = 255— Super ID. May perform any operation in the system. 

Can update or purge any file. This user is often 
identified as -1 on the system. (For example, as 
owner in a fup info listing.) 

(group id) = 255, (user id) = 254— System Operator. May perform standard’ and 

hardware-oriented operations. 

(group id) = 254, (user id) = 255— Group Manager. May perform standard operations* 

and define new Tandem users within the group. 
Has access to all files belonging to his group, ex¬ 
cept files restricted to Super id. 

(group id) = 000, (user id) = 000 —Standard (null) User. 

♦Standard operations include creating and purging disk files, running programs, display¬ 
ing system status, and so on. In System/55 these abilities apply only to users with 
Command Interpreter authority. This is not a recommended authority for standard 
users. 

There may be only one super id and only the super id can define new 
groups; this user is therefore the “group manager” of all groups. Although 
up to 256 groups of 256 users each are possible, we will generally prefer to 
narrow the accounts to those few that will have real meaning in our 
publishing system. (If a separate data processing system is configured, a 
broader range of groups and users may be defined.) Wherever possible 
we will let the more specific authorities in the User Profile control the range 
of a user’s activity in the system. 

It should be noted that group id 253 is not necessarily a higher security 
level than group id 147. 

User Definition 

When a new System/55 is presented to the customer during the prein¬ 
stallation staging, a degree of security will already have been defined by 
Sll. At that time your Sll Site Manager will advise you in defining any new * 
Tandem users you may require. 

Three Tandem users are required for system operations: super.super 
(255,255), super.sched (255,253), and su. super (254.255). These users 
must not be changed. 

Tandem users are defined with the comint ( Tandem Command Inter¬ 
preter, not Sll Command Interpreter) adduser command in which both 
names and numbers are supplied for group and user. The syntax is: 

: ADDUSER (group name), (user name) , (group ID), (user ID) 

Execute comint through the Sll Command Interpreter ( |cmd| Q]). The 
following are recommendations: 

• Super ID 

There may be only one Super ID per system (“system” is defined here 
as being a node of the network, not a locally configured system). This 
user must be named super.super (255,255). 
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Use of super.super should be limited to an absolute minimum of 2 
persons and a probable maximum of 4 persons at any site. The mini¬ 
mum of 2 persons covers illness and vacations; the maximum is in 
recognition of the great power and responsibility this user has. The 
super.super user is immune to all system security and thorough sys¬ 
tem knowledge is imperative for its use. 


In a network, a node’s super.super user has no special capabilities on 
a remote system, nor do any other users. All users are limited by the file 
security effect on any particular system (see “File Security" later in this 
section). 


• System Operator 

There should be one System Operator user per system. By convention 
this user is named super. s (255,254). This user will normally be used 
by maintenance personnel and those individuals who monitor the hard¬ 
ware of the system. 


• Group Manager 

The group manager class of user is signified by a user id that is equal to 
255, the same user id as the super.super user. A group manager must 
be added to the system by the super.super user. A group manager has 
the capability of adding new users to his g'roup, but generally this 
capability is not applicable to a publishing system (it is not useful to have 
additional members of the group). Therefore, the super.super user 
should be responsible for adding all new Tandem users. 


This class of user is a means of exercising unique control over 
System/55 users with Command Interpreter authority, who otherwise 
are fairly unrestricted in their activity. The way it is employed depends 
on the distribution of knowledge and responsibilities at the site. For 
example,'the knowledge (background, training) and aptitude required to 
write styl procedures, to specify wire routing procedures, to define 
advertising operations, to maintain the vdt character matrix library to 
maintain devices and fonts, to schedule programs and to write specifica¬ 
tions for reports may not all be found in a single individual, or a single 
function (job description) being filled by more than one individual. It is 
also possible that the system manager (super.super) would avoid 
delegating all of these responsibilities to a single function (role) being 
performed by one or more persons. Any or all of the following groups 
might be added to delegate and restrict responsibilities: 

Group.User Group,User 

Names Numeric IDs Permitted Function 

SCHED.SUPER 101,255 Defining User Access to Programs, 

Program Scheduling and Message Groups 
WIRE.SUPER 102,255 Defining Wire Routing 

CLASS.SUPER 103,255 Defining Advertising Operations 

DICT.SUPER 104,255 Dictionary Maintenance 

FONT.SUPER 105,255 Defining Dovices and Fonts 

and Maintaining the vdt Matrix Library 
STYL.SUPER 106,255 Compiling stvl Procedures 


Each of the above users is restricted to a set of functions typical of a 
newspaper publishing system. Any individual, given knowledge of the 
appropriate password, may logon as any one of these users prior to 
performing the related function(s). Later in this section, under “File Securi¬ 
ty,” we’ll discover how we can give data files to these Tandem users and 
then secure them. 
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Note that Form Generation and List Generation are not among the func¬ 
tions restricted to these groups. Those processes are more effectively 
controlled by levels in the User Profile. It is not required that any of the 
above areas be restricted in this way. Similar objectives could be accom¬ 
plished by more severely limiting Command Interpreter authority and 
granting users access to programs only with the program scheduler 
schedset (see Section 87). The limitation in doing so is that only program 
execution is prevented, files are not protected (access with the Index 
command is more difficult to prevent), and capable users are unnecessari¬ 
ly restricted. This method provides a balance between slamming the door 
shut on information and leaving it wide open, neither of which extreme is 
desirable in a publishing system. 

• Standard User 

All other users in a system are Standard Users known as null.null 

(000,000). These are norma! editorial and advertising users who do not 

have Command Interpreter authority. However, they may have Utility 

Authority and a list of Available Processes. 

A System/55 econtrol or ccontrol user, when first created, is a 
null.null Tandem user. He will remain as such until he is shown how to 
change his account by logging on as a higher level Tandem user with the 
appropriate password. Users may be graduated through the hierarchy of 
Tandem users by being given additional training, new responsibilities, and 
knowledge of a new Tandem user name and its password. Only users with 
Command Interpreter authority may become other than null users. 

When a System/55 user signs on under either the econtrol (editorial) 
or ccontrol (advertising) vdt control process, he or she is automatically 
signed on as a Tandem user under the default account number in the User 
Profile. This Tandem user status is checked by any user commands 
reading or writing to files other than those containing takes, baskets, and 
desks; these are special files that are generally available within the bounds 
of implicit or explicit authorities in the User Profile. 

Passwords 

All Tandem user names should be protected with passwords. Pass¬ 
words are assigned with the Tandem comint Password command (see 
Guardian Operating System Programming Manual, “Security System”). 

Define a hidden password on an interactive Sll editing terminal by 
entering IctrlI [p] between the Password command and the password 
itself: 

: password ICTRLI [p] (new password) 

This prevents the password from being displayed on the screen. Pass¬ 
words may consist of one to eight characters, no blanks, nulls or commas 
are allowed. In addition, the following characters may not be used from the 
osp a,c,e,h,m,n,q,r.s,x,y (upper- or lowercase). Passwords are case sensi¬ 
tive. 

Enter a password in the comint logon command on an interactive Sll 
editing terminal by preceding it with IctrlI (pJ. Consult your Sll System 
Engineer for instructions on how to logon to console terminals. 

When changing the password of any Tandem user, be sure to check 
processes scheduled in schedset (see Section 87) that may run as that 
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Tandem user to make certain that the passwords match. Scheduled pro¬ 
cesses created by the scheduling monitor are treated as though they were 
system users. In some cases they may have to execute as a specific 
Tandem user in order to have access to the program file and the data files 
it opens. The correct password must be specified with schedset in order 
for the Tandem user to sign on. 

The frequency with which passwords are changed depends on the 
judgment of the system manager. In order that password security may be 
properly coordinated, the responsibility for changing passwords should lie 
only with the system manager or other super.super user delegated as 
“password editor.” Periodically this user should change all of the pass¬ 
words (including remote passwords, where appropriate) and inform the 
affected users of the changes orally. It is important that passwords never 
be written down, for that invalidates their purpose. 

Whenever an employee with access to other than a null.null user 
resigns or is dismissed, it is a useful precaution to immediately change the 
passwords of all user names of which he or she may have knowledge. 

Network remote passwords should be coordinated with Sll (for as long 
as you choose to participate in the Sll Network) and with all other nodes of 
the network with which you desire interaction. 

File Security 

Once all the Tandem user accounts have been defined, it is necessary 
to complete the picture by “giving” certain important data files to specific 
user accounts and then “securing” them. The super.super user may give 
a user the ability to read a file, to write to it (change it), execute it (if a 
program) or purge it, both locally (within the node of the network) and by 
similar users in other nodes of the network. 

Relating Tandem File Security to System/55 

There are four types of access for a file: 

read, 

write, 

execute (run), and 
purge. 

Through fup (File Utility Program; see Tandem Guardian Operating 
System Command Languages and Utilities Manual), for each of these four 
types of access a file may be secured on any one of seven levels, each of 
which is represented by a letter or symbol. 

Local: 

a = any local user, including super.super 

g = any local member of the same group, the owner or local super.super 
o = owner, local super.super, or local group super 
- = (hyphen) local super.super only 
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Network: 

n = any network user, local or remote 

c = community members (any user on any system whose group id 
matches that of a file’s owner) and local or remote super.super 
u = local or remote owner, local or remote super.super, and local or 
remote group super 

Only local security is bypassed for the super.super user. A file may 
have only one owner; the file’s “owner” is the creator of the file or a user id 
to which the file is given with the fup give command. 

Both the local and network levels of security are meaningful in 
System/55. A major feature of System/55 enables SI! to support its cus¬ 
tomers through the Guardian/Expand Network. Many customers, in turn, 
support remote sites as nodes of the network. Together, all nodes—Sll, 
each customer’s central node (the newspaper) and remote nodes (bu¬ 
reaus) established for individual customers—form the Sll Network. Explicit 
cooperation is required between the respective super.super user of the 
nodes of the network in establishing remote passwords. 

In reading the examples and the levels of security suggested for specific 
files in the balance of this section, be aware of how the vdt control 
processes examine the security levels: 

• The program and data files accessed by all user commands—except for 
the List, Form, and Start Process commands—are opened by the vdt 
control process as user super.super. That ensures that standard users 
may not be inhibited by the Tandem security system from performing 
their tasks, regardless of a file's ownership. 

• The List command ( IcmdI 0) examines the read access level any data 
file (program files cannot be indexed) a user attempts to index. If this 
level is other than n, standard users are prevented from-obtaining 
indexes of the data in the file. 

• All three levels of the Form command ( Icmdi [?]) examine the execute 
access level of a data file , not the write level. This lends a great deal of 
freedom to the securing of data files. Data files are not programs and 
cannot be executed; the Tandem security system does not examine the 
execute access level for a data file, since it is inapplicable. The Form 
commands do examine this level, however, without subverting Tandem 
security. 

If the write level is low (n) and the execute level is high (c, u or -), most 
users can be prevented from accessing records in the file with the Form 
commands; records may still be accessed with any program that up¬ 
dates them, provided the user has execute access to that program file. 

If the write level is high and the execute level is low for a data file, data 
records can be easily accessed with the Form commands, but access 
by other means requires a much higher level Tandem user. 

Note that these factors are not true of the header files, user files, desk 
and basket files; these are special System/55 files to which access is 
controlled in the User Profile. 
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Note: A program in a user’s List of Accessible Processes does not 
exempt that program and the user from execute access checks. It 
simply allows the user to execute the program without Command 
Interpreter authority. 

Examples of the security levels applying both locally (at each node) and 
within the network follow. The headings have the following meanings: 


r = read, 

Examples: 

RWEP 

N C N C 


w = write, 


e = execute, and 


purge— rwep. 


cue 


Discussion 

This is the security with which Sll normally supplies files to 
customers. Any network user may read; only community 
members may write; any network user may execute; only 
community members may purge. Writing and purging are the 
most critical capabilities. All files, as supplied, are initially 
owned by super.super users within the network, but only 
those with whom remote passwords (allow access/request 
access) have been established. Initially, access is only be¬ 
tween Sll and the customer site. 


CAUTION 

So that Sll may give you continuing support 
through the Sll Network, please continue to use 
the network security— n, c, and u—for all 
System/55 program and data files supplied by Sll, 
except for Purge access, which should be 
changed to (local super.super only) whenever 
ownership of a file is given to a user other than 
super.super. If local read, write, and execute lev¬ 
els are assigned to files, your Sll System Engineer 
will be unable to render assistance through the 
network 


RWEP 

C C C - 


c u u 


Discussion 

Anyone in the network community may read, write or 
execute, but only the local super.super may purge. This 
would make sense only for files that do not need to be 
available to standard users, even for listing. 

Anyone in the network community may read, but only a 
network user with the same id as that of the owner may write 
or execute and only the local super.super may purge. If a 
program file owner’s id is 250,255, the only users who may 
write or execute are the owner, a network user id of 250,255 
or the local or remote super.super (255,255). If these ac¬ 
cess levels were assigned to a data file , only users with the 
same id as that of the file's owner would be able to change 
data in the file, with or without the form command; only the 
community members could read the file, including using the 
data in a report. 

Any community user may read or execute, but only users 
with the same id as that of the owner may write to the file, 
and only the local super.super may purge it. This is a useful 
variation on the above combination of access levels. 
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u u u - Only network users with the same id as that of the owner 
may access the file, and only the local super.super may 
purge it. This is the most restrictive form of network security, 
whether it be for a data file or a program file. It could possibly 
apply to the font files, with the exception of the font header 
file (see next example). , 

n u u - Any network user may read this file, but only users with the 
same id as that of the owner may write to it or execute it, and 
only the local super.super may purge it. This too, is fairly 
restrictive. It would be useful to secure the font header file 
(SYSTEM.s/'fe. fonts, where site is your site’s designator) in 
this way. Useful indexes of font names, descriptions, and so 
on, would therefore be available to all users. 

n n n n No!! This is the equivalent of no security at all. 

Files created locally by your own programming personnel may use the 
local security levels a, g, and o. 

File Names 

Data files and program files have names in the form: 

[\{system). ] $(volume name), {subvolume name), (disk file name) 

The node of the network (\) is shown here only because it is part of a 
complete network file name. Locally, you will specify file names only with 
that portion of the name beginning with the dollar sign ($), and that is the 
way they are shown throughout the following discussion. 

For the purposes of this discussion, the volume name is unimportant, 
since it will vary from site to site with the number of disk drives and data 
organization. To properly represent complete file names, however, all 
volumes are referred to as Ssystem. 

In many instances, subvolume name will be a designator unique to your 
site: Ssystem.sjmn.name. In these cases, the subvolume name is repre¬ 
sented as site: SsYSTEM.s/fe.NAME. 

Lists of files in your system and detailed information about them can be 
obtained with the fup Files and Info commands. The Subvols command is 
also useful for listing the subvolume names on a designated volume. 

“Giving” File Ownership 

In order to delegate responsibility and, subsequently, to restrict access 
within the system, it is useful for the super.super user to “give" the 
ownership of certain data files (but not program files) to other users. Only 
the owner of the file and the local super.super can “give” ownership of a 
file to another Tandem user. This is the equivalent of saying “Here, this is 
your responsibility.” 

The greatest number of files must be retained under the ownership of 
super.super. Those files discussed here are some of the data files re¬ 
quired by you and your personnel for controlling and customizing your 
system. 

The names of most data files whose ownership you might wish to 
change may be found in an index of your configuration file. You may also 
list files in which you are interested with the fup Files command. The fup 
Info command may be used to list files with security information, along with 
other details about them. In the “Owner” column of the list, -1 means 
super.super: all other owners are indicated with their numeric ids. This 
list also displays the files' access levels. 
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Since no two publishers organize their personnel in precisely the same 
way, it is difficult to make clear-cut recommendations here. What we will do 
instead is illustrate aspects of a theoretical security system to make you 
aware of the possibilities. 

Most file security is set up by the Sll System Engineer during system 
staging and. installation. 

Recall the group managers suggested earlier in this section: 

Group.User Group,User 

Names Numeric IDs Permitted Function 

SCHED.SUPER 101,255 Defining User Access to Programs, 



Program Scheduling, and Message Groups 
Defining Wire Routing 
Defining Advertising Operations 
Dictionary Maintenance 
Defining Devices and Fonts 


WIRE.SUPER 
CLASS.SUPER 
DICT.SUPER 
FONT.SUPER 


102.255 

103.255 

104.255 

105.255 


and Maintaining the vdt Matrix Library 
Compiling styl Procedures 


STYL.SUPER 


106,255 


To each of these Tandem users we, as super.super, will give the data 
files relating to their functions. This is done with the fup Give command: 

.'-give $system. site. wtime, 102,255 

These users represent specialized areas of system knowledge and/or 
responsibility. The files listed below enable them to perform within bounds 
of their functional roles. The lists of files are not necessarily complete; new * 
files to support new features are constantly being added. Moreover, file 
names may be different at various sites and certainly will differ, where 
appropriate, between systems at the same site. Consult your Sll Site 
Manager for assistance. 

Note that only data files are given to these users, riot program files. 
Programs must remain under the ownership of the super.super user. A 
program may be executed by a user only if that user has access to the 
data files opened by the program. 

Owner Data File Name File Description 

SCHED.SUPER SSYSTEM.SCHED.PROGRAMS Available programs/descriptions 



SSYSTEM.SCHED.GRPACC 


Group to program relationships 
Alternate key file 
Alternate key file 

User to group/program relationships 

Alternate key file 

Alternate key file 

Program execution times 

Alternate key file 

Alternate key file. • 

Physical vdt group definitions 
Editorial message group definitions 
Advertising Message group definitions 


SSYSTEM.SCHED.GRPACC0 
SSYSTEM.SCHED.GRPACC1 


SSYSTEM.SCHED. USERS 
SSYSTEM.SCHED.USERS0 
SSYSTEM.SCHED. USERS1 
SSYSTEM.SCHED.TIMES 
SSYSTEM.SCHED.TIMES0 
SSYSTEM.SCHED.TIMES1 
SSYSTEM.s/fe.DEVDESC 
SSYSTEM.s/te.EFILE 


SSYSTEM.s/te.CFILE 


This user, with program schedset, has the responsibility for defining the 
Lists of Available Processes for all users and for scheduling the automatic 
execution of programs. This user is responsible also for securing terminals 
by assigning them to groups, and for defining message groups to be used 
for message and transfer alert messages within the system. Note that 
most of these files are the same for all configured systems. Each system 
may have a separate message group file, as shown here, or they may all 
share the same file. 
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Owner Data File Name 

WIRE.SUPER SSYSTEM.s/fe.WTIME 

$SYSTEM.s/fe.WTIMEO 
$SYSTEM.s/fe.WHEAD 
SSYSTEM.s/fe.WHEADO 
$SYSTEM.s/fe.WKEYWD 
$S Y STEM .s/'fe. WK E YWDO 
SSYSTEM.s/fe.WTABCODE 
SSYSTEM.s/fe.WSTATUS 

This user is the newspaper’s expert 


File Description 

Routing based on days and times 
Alternate key file 

Routing based on wire service headers 
Alternate key file 
Routing based on keywords 
Alternate key file 

Coding replacements for tabular takes 
Data on last take received for each wire 

on wire handling and routing. He 


cooperates with wire editors in the definition of wire baskets and desks, 
routing specifications, and transfer alert groups (sched.super actually 
defines the users belonging to message groups). 


Owner Data File Name 

CLASS.SUPER SSYSTEM.s/fe.CLASSC 
SSYSTEM.s/'fe.ADTYPEC 
SSYSTEM.s/fe.CMASTER 
SSYSTEM.s/fe.CMASTERO 
SSYSTEM.s/fe.CREDIT 
SSYSTEM.s/fe.PUBGROUP 
$S Y STEM .s/fe .RATES 
SSYSTEM .s/fe.TRANS 


File Description 

Advertising control records 

Ad type definition records 

Customer information records 

Alternate key file 

Bad credit records 

Publication group/edition definitions 

Rate tables 

Info-only transaction statistics 


Responsible for defining all functional details of the advertising system. 

Owner Data File Name File Description 

DICT.SUPER SSYSTEM.DICT.MASTER Dictionary 


This user is responsible for maintaining the complete dictionary used for 
hyphenation and Spellbinder. No other user, except for super.super, may 
add, edit, or delete words. It is recommended that several persons be 
designated as “dictionary editors” and that all proposed changes be routed 


to them. 

Owner Data File Name 

FONT.SUPER $S Y STEM .site . DEVT ABLE 

$SYSTEM.s/fe. FONTS 
SSYSTEM .s/fe. FONTSO 
SSYSTEM.s/fe. INDEX 
SSYSTEM .s/fe. IN D EXO 
SSYSTEM.s/fe.INDEXt 
SSYSTEM.s/fe. WIDTH 
SSYSTEM.s/fe.FWIDTHS 
SSYSTEM.s/'fe.CHARS 
SSYSTEM.s/fe.MATXREF 
SSYSTEM.s/fe. LOCALM AT 
SSYSTEM.s/fe.XYZZ 
SSYSTEM.s/fe.GRAPHICS 


File Description 

Typesetting device records 

Font header records 

Alternate key file 

Index to recode and width tables 

Alternate key file 

Alternate key file 

Font width and recode data 

Film width/device location records 

Global library of vdt character matrices 

Index to site’s local character set 

Local matrices stored by tcu 

xyzz values for all internal codes 

Printer graphic strings for all internal codes 


Responsible for all typesetting devices, 
matrix library. 

Owner Data File Name 

STYL.SUPER SSYSTEM.STYL.STYLDESC 1 

SSYSTEM.STYL. VARIABLE 2 
SSYSTEM.STYL.CONSTANT 2 
SSYSTEM.STYL.OPERANDS 2 
SSYSTEM.STYL.KEYWORDS 2 
SSYSTEM.STYL.STYLCODE 3 
SSYSTEM.STYL.STYLINDX 3 
SSYSTEM.STYL.STYLSPCE 3 


fonts, keyboard tables, and vdt 

File Description 

styl name/description records 
Names of styl variables 
Names of styl constants 
Names of styl operands 
Names of styl keywords 
Compiled styl procedures 
Index to styl procedures 
styl space remaining 


^sed for an index of styl procedures available to ail users. 

2 Contain all of the reserved words used in the writing of styl procedures. 
Only “keywords” is not available for lists. 

3 For system use only. 

Any System/55 user writing styl procedures may logon as this user. Other 
users may not add or change procedures. 


97.10 



System Management Topics 


Defining Tandem Security 


Securing Files 


Once the ownership of files has been established, it is necessary to 
secure them within the network. Here we will concern ourselves with only 
those data files “given” in the discussion above. 


In terms of a data file, Read access applies to the ability to read the data 
in a list ( ICMOI 0 or, in the case of the dictionary, |cmd| 0) or a report 
(rgen), or to access it by executing a program that opens the file; without 
read access to the file, a user may not view the data under any circum¬ 
stances. Write access applies to the ability to change (add, edit, delete) 
data in the file through execution of a program. Execute access for data 
files applies only to the ability to add, edit, or copy data with the various 
levels of IcmdI 0. Purge access applies to the deleting of records in a file 
with IcmdI □ [k] or to deleting an entire file; normally, this access must be 
reserved for the local super.super user. 


A user’s ability to run a program depends on the program’s execution 
access and on how the program opens the data file(s)—for reading only or 
for reading and writing (most programs). If a program opens a file as 
read-only and the user has read access to the file, the user may execute 
that program. If a program opens a file for reading/writing, the user must 
have access to the file on both levels in order to run the program. 


All security violations encountered while a user is running under a vdt 
control process (econtrol or ccontrol) are reported on the status line 
as “Outside your jurisdiction.” 


Violations encountered when you attempt to run a program from an Sll 
or Tandem Command Interpreter are reported and and normal execution 
of the program is halted. 


In assigning security levels to data files, it is necessary to give careful 
thought on an individual file basis to who may view (i.e., read) and who 
may change (write, execute) data. Lists available on vdts and in hardcopy 
form must be considered, and so must reports compiled with the Report 
Generator rgen. A user may not obtain a report or list that opens a file to 
which he does not have access. 


We may now proceed in securing our files. This is dene with the fup 
Secure command: 


-secure $system.sched.programs, ’mi--’ 

Only the owner of the file and the local super.super can secure a file. 
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Owner: SCHED.SUPER Security 


File Name 

R W 

E 

P 

Comments 

SSYSTEM.SCHED. PROGRAMS 

N U 

* 

* 

Any user may read; only owner’s id may write; only 
super.super may execute (vdt forms are not permit¬ 
ted for updating records) or purge. 

SSYSTEM. SCHED.GROUPS 

N U 

- 


Same. 

SSYSTEM.SCHED.GRPACC 

N U 

- 


Same. 

SSYSTEM.SCHED.GRPACCO 

N U 

- 


Same. 

SSYSTEM.SCHED.GRPACC1 

N U 

- 


Same. 

SSYSTEM.SCHED.USERS 

N U 

- 


Same. 

SSYSTEM. SCHED. USERSO 

N U 

- 


Same. 

SSYSTEM.SCHED.USERS1 

N U 

- 


Same. 

SSYSTEM.SCHED.TIMES 

N U 

- 


Same. 

SSYSTEM.SCHED.TIMES.O 

N U 

- 


Same. 

SSYSTEM.SCHED.TIMES1 

N U 

- 


Same. 

SSYSTEM.s/te.DEVDESC 

N U U 


Any user may read; only owner’s id may write or 
execute (vdt forms are normal method for updating 
records); only super.super may purge. 

SSYSTEM.s/fe.EFILE 

N U U 

- 

Same. 

SSYSTEM.s/fe.CFILE 

N U U 

- 

Same. 


Owner:WIRE.SUPER 

Security 



File Name 

R W E P 

Comments 


SSYSTEM.s/fe. WTIME 

NUU • 

Any user may read; only owner's id may write or 
execute (vdt forms are normal method for updating 
records); only super.super may purge. 

SSYSTEM.s/fe.WTIMEO 

NUU • 

Same. 


SSYSTEM.s/fe.WHEAD 

NUU ■ 

Same. 


SSYSTEM.s/te.WHEADO 

NUU - 

Same. 


SSYSTEM.s/fe.WKEYWDO 

N U U - 

Same. 


$SYSTEM.s/fe.WTABC£DE 

NUU • 

Same. 


SSYSTEM.s/fe. WSTATUS 

N - - - 

Information-only file. Any user may read. 
super.super may write, execute or purge. 

but only 


OwnerCLASS. SUPER 

Security 


File Name 

R W E P 

Comments 

SSYSTEM.s/fe.CLASSC 

NUU • 

Any user may read; only owner's id may write or 
execute (vdt forms are normal method for updating 
records): only super.super may purge. 

SSYSTEM.s/fe.CMASTER 

N U N - 

Same. 

SSYSTEM.s/fe.CREDIT 

NUU ■ 

Any user may read; only owner's id may write or 
execute (vdt forms are normal for updating records); 
only super.super may purge. 

File Name 

R W E P 

Comments 

SSYSTEM.s/fe.PUBGROUP 

N U U - 

Same. 

SSYSTEM.s/fe.RATES 

NUU • 

Same. 

SSYSTEM.s/fe.TRANS 

N - - - 

Information only file. Any user may read, but only 
super.super may write, execute or purge. 


Owner :DICT. MASTER 

Security 


File Name 

R W E P 

Comments 

SSYSTEM.s/le.CLASSC 

N U - - 

Any user may read; only owner's id may write: only 
super.super may execute (vdt forms are not permit¬ 
ted for updating records) or purge. 
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Owner:FONT.SUPER 

Security 


File Name 

R W E P 

Comments 

SSYSTEM .site DEVTABLE 

N U - - 

Only owner’s id may read or write: only super.super 
may execute (vdt forms are not permitted for updating 
records) or purge. 

SSYSTEM.s/fe.FONTSO 

N U U - 

Same. 

SSYSTEM.s/te. INDEX 

N U - - 

Only owner’s id may read or write: only super.super 
may execute (vdt forms are not permitted for updating 
records) or purge. 

SSYSTEM.s/te.INDEXO 

N U - - 

Same. 

SSYSTEM.s/te.INDEXI 

N U - - 

Same. 

SSYSTEM .s/fe. Wl DTH 

N U - - 

Same. 

SSYSTEM .s/'te. FWIDTH 

N U - - 

Same. 

SSYSTEM.s/Ye.CHARS 

N U - - 

Same. 

SSYSTEM.s/fe.MATXREF 

NU • ■ 

Same. 

SSYSTEM .site . LOCALM AT 

N U - - 

Same. 

SSYSTEM .site .XYZZ 

NU - • 

Same. 

SSYSTEM.s/fe.GRAPHICS 

N U - - 

Same. 

OwnerSTYL.SUPER 

Security 


File Name 

R W E P 

Comments 

SSYSTEM.STYL.STYLDESC 

N U U - 

Any user may read; only owner’s id may write or 
execute (vdt forms are normal method for updating 
records’); only super.super may purge. 

SSYSTEM.STYL. VARIABLE 

U - - - 

Information-only to writer of styl procedures. Only 
owner’s id may read; only super.super may write, 



execute, or purge. 

SSYSTEM.STYL.CONSTANT 

u - - - 

Same. 

SSYSTEM.STYL.OPERANDS 

u - * - 

Same. * 

SSYSTEM.STYL.KEYWORDS 

u - • ■ 

Same. 

SSYSTEM.STYL.STYLCODE 

uu - • 

Only owner's id may read or write: only super.super 
may execute (vdt forms are not permitted for updating 
records) or purge. 

SSYSTEM. STYL. STYLIN DX 

u u - - 

Same. 

SSYSTEM.STYL.STYLSPCE 

u u * - 

Same. 


*A styl description is given in a statement in the procedure itself and is loaded when the procedure is 
compiled. An existing description may be changed by editing its record in this file, or preferably, by 
changing it in the source take and recompiling the procedure: or both, if you do not wish to recompile 
the procedure. 


Observe that for some data files vdt forms are the normal method of 
adding, changing, and deleting information in records; but for other files 
this is not permitted since a specific application program is required to 
validate the data. The other type of data file of note is one in which the data 
is updated by a process (running program); these files are always 
read-only to users. 


In the security recommendations above, only super.super has purge 
access to all files. This means that other users may not delete records with 
IcmdI (T| 0 (does not apply to record deletion with an application program 
such as fmod). You may wish to relax this restriction for certain files (e.g., 
wire routing files) by giving them a purge access of o (local owner or 
SUPER.SUPER only). 


There may be other files in your system that are worthy of security 
considerations. Please discuss these with your Sll System Engineer. 
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PROGID SECURITY OPTION 


NORMAL SECURITY 

1. COMMAND INTERPRETER LOGGED ON AS NULL.NULL 0,0 

2. $SYSTEM .SYSTEM. ED IT SECURED 254,255 NCNC 

3. $SYSTEM.STUDENT.FRUITS SECURED 254,254 CCCC 



PROGID OPTION 

1. COMMAND INTERPRETER LOGGED ON AS NULL.NULL 0,0 

2. $SYSTEM.SYSTEM.EDIT SECURED 254,255 NCNC,PROGID 

3. $SYSTEM.STUDENT.FRUITS SECURED 254,254 CCCC 



ALL TANDEM AND Sll DISC FILES ARE SECURED WITHOUT PROGID EXCEPT THESES: 

1. VCONTROLS - SII.ECONTROL, Sil.CCONTROL, etc. 

2. $SYSTEM.SII. I NMON 

A-00079 


Figure 97.1. progid Security 
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SECTION 98 

VDT Security 


System/55 provides two methods for securing the use of vdts and user 
names: 

1. by assigning vdts and users to groups representing their physical 
locations and/or functions, and 

2. by allowing users to secure their user names to vdts when they sign 
off. 


Defining VDT Groups 

VDTs are grouped by completing a record like the one illustrated in 
Figure 98.1 for every terminal in the system. There should be such a form 
in your system. The normal form and list names are terminals; the data 
file is $SYSTEM.s/'fe.DEVDESC and the structure is device'desc. 


VDT name SF2.#L11 

Group Contract Ad 

Description Mary Green's desk 



Figure 98.1. Terminal Description Record 


Three fields are available in this record: 

vdt name —This is the name of the vdt and also the key to its physical 
connection in the system. The name is composed of two parts, sepa¬ 
rated from each other with a period. The first part identifies the 
terminal controller to which the vdt is connected—in this case, $F2— 
and the second part identifies the slot in the controller— #li i —into 
which its communications or controller board is plugged. The com¬ 
plete name— Sf2.#lii —is used to identify the terminal in transac¬ 
tions between the terminal controller and the host computer, allowing 
the vdt to interact with its process (each terminal has its own process 
in the host computer). This particular process name would appear in 
compressed form in the configuration file as $F2ii —controller F2, 
terminal # 11 . These conventions permit terminal names to be used 
throughout the network. 


group —The group (up to 12 characters) to which the vdt and the users 
who may sign on to it belong. Groups are as you define them here 
and in User Profiles, in which each system user may be assigned to a 
group (not be be confused with message groups, which are not 
reflected in User Profiles). See additional discussion below under 
“Assigning Terminals and Users to Groups.” This grouping, although 
desirable, is not required. 


description —The description (up to 30 characters) of the vdt’s use, 
which should be the name of the terminal’s user or the function 
normally performed on that terminal. This description is displayed on 
the status line following the name of the system when the vdt is 
signed off or in an idle state. 
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The describing of vdts in this record is a means of personalizing the 
system (including making users more comfortable with it) and of exerting 
control; it is not required for system operation. If you do not create a record 
for the vdt or if you create a record but do not give a description, the vdt’s 
name (in this case $f2.#lii) will be displayed as the description. It is 
useful for keeping track of the physical location of the terminal; however, 
that location is assigned to the controller (cabled to the terminal) rather 
than the terminal itself. If the terminal is connected to a different controller, 
a different terminal description record is used for that displayed informa¬ 
tion. 

Assigning Terminals and Users to Groups 

The group named in the Terminal Description Record corresponds to 
the group named in the User Profile: 

• If all vdts are assigned to groups and no group is specified in a user’s 
profile, that user may sign on to any vdt. This capability is intended for 
certain production personnel who may be called on for assistance in 
non-production areas. 

The terminal description file is common to the entire site, regardless of 
how many systems have been configured. The only reason for defining 
VDT/user groups is to restrict the use of vdts in specific locations. If this is 
not desired, the group field should be left blank in both the Terminal 
Description Records and in User Profiles. 

In the simplest of situations, imagine that we have two VDT/user 
groups— “editorial” and “classified.” All vdts located in the newsroom 
and other editorial offices are assigned to the editorial group; those vdts 
located in the classified department are assigned to the classified group. 
Likewise, editorial and classified users are assigned to these respective 
groups in their respective User Profiles. The result is that an editorial user 
may not sign on to the editorial system on a classified vdt and classified 
users are not permitted to sign on to their system in the newsroom. 

Carrying this control further, the classified and editorial areas may be 
broken down into more specific groups. In the classified department, for 
instance, the groups “solicitor,” “credit,” and “censor” would limit the 
use of vdt in an area to users assigned to that area. Similarly, in editorial, 
the groups “city,” “national,” “sports,” “leisure,” and so on, would 
prevent editors and reporters from using vdts outside their assigned ar¬ 
eas. If the site has word processing users, the group “wp” could prevent 
them from using terminals in classified or in the newsroom. This can be an 
effective way of preventing employees from using each other’s desks. 

If the group field in the User Profile is empty, that user has no such 
restrictions. This would be useful for users who need to use any terminal, 
such as maintenance personnel. 

group can also be applied to a single user-terminal relationship. A 
managing editor whom we will call “John Smith" has a vdt in a private 
office. John's vdt is assigned to group “john smith;” in John's User 
Profile, and in no other, the group “john smith” is specified. Only John 
Smith may sign on to the vdt in his office. John himself may not sign on to 
any other terminal, at least not as “John Smith.” 
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Signing-off at a Secured Location 

Users may secure their user profiles at specific vdts by signing-off with 
the second level sign-off command— IcmdI \T\ \z\. This method prevents 
the user name from being used on any other vdt in the system. It does not, 
however, prevent other users from signing on to the terminal under their 
own user names. It is presumed that a vdt signed-off with IcmdI □ [z] is in 
a locked office; otherwise this practice has little meaning. This form of 
security is totally independent of vdts and users secured by the group 
method. 


Returning to the example of John Smith, whose terminal is secured by 
virtue of his own proprietary group, it would be redundant for him to sign off 
in this way. In his case, the group accomplishes the same objective as 
IcmdI . I \z\ and provides the additional benefit of preventing other user 
names from being used at his vdt. As far as the vdt is concerned, there is 
no reason for him to lock his office unless he has been careless in letting 
other persons know his password. 

If the user attempts to sign on at another terminal he will “strike out.” The 
logical'vdt field in the user profile can be used to determine if a user 
signed off using IcmdI Q \z\. 
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° SECTION 99 

System Obey Files 

System Obey Files make it possible for you to store commonly executed 
command procedures for easy access and use. Files are created using the 
Tandem Edit utility. See Tandem GUARDIAN System Operation Manual 
for information on the use of the edit utility. 

The obey files illustrated here are provided as examples only and are 
intended to aid you in writing obey files for use on your system. 

BALCPU1 Obey File 

This is a site-specific obey file. The example in Figure 99.1 is provided 
only as a guide in writing a similar file for use on your system. 

Standard 

Disk File Name: Ssystem.obey.balcpui 

Description: This obey file should be executed following unex¬ 
pected* shutdown of a cpu. Lists all the processes 
that should be in cpu i and stops them so that they 
are returned to cpu i . 


1 

who 


2 

COMMENT: 


3 

COMMENT: 

YOU MUST BE LOGGED ON AS SUPER.SUPER! 

4 

COMMENT: 


5 

delay 10 


6 

* pup primary 

SO. 1 

7 

pup primary 

Sncp.1 

8 

pup primary 

Soso.1 

9 

pup primary 

Sdata.1 

10 

pup primary 

Siril.1 

11 

pup primary 

Siri2.1 

12 

pup primary 

Siri3. 1 

13 

pup primary 

Siri4.1 

14 

pup primary 

St6530.1 

15 

pup primary 

Soki.1 

16 

pup primary 

Sslp.1 

17 

pup primary 

Squmel.1 

18 

pup primary 

Sasvnc.1 

19 

pup primary 

Saphi.1 

20 

pup primary 

SuciallO.1 

21 

pup primary 

Sucialll.1 

22 

pup primary 

Suciall2.1 

23 

pup primary 

Suciall3.1 

24 

pup primary 

Suciall4.1 

25 

pup primary 

SuciallS.1 

26 

pup primary 

Sfl. l 

27 

pup primary 

Sf 3. 1 

28 

pup primary 

Sf 5. 1 


Figure 99.1. balcpui Obey File (partial) 
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29 stop Seprg 

30 stop Seprg 

31 stop Scapl 

32 stop $eap2 

33 stop Seahl 

34 stop Scahl 

35 stop Scajl 

36 stop Sedta 

37 stop Sedta 

38 stop Scprf 

39 stop Sequm 

40 stop Seqmh 

41 stop Seqmj 

42 stop Seqmj 

43 stop Scsve 

44 stop Sctr 

45 stop Semsg 

46 stop Scvpt % 

47 stop Scupd 

48 stop Sefio 

49 stop Scvgt 

50 stop Sefil 

51 stop Sebrt % 

52 stop Sotmn 

53 stop Sschd 

54 stop Scrck 

55 vup/in sysdata.config/send icpu 1 THIS TERMINAL WILL BE STOPPED IN 1 MINUTE TO REBALANCE 
THE PROCESSORS. 

56 delay 10 seconds 

57 vup/in sysdata.config/send icpu 1 THIS TERMINAL TO BE STOPPED IN 40 SECONDS... PLEASE SIGN 
OFF. 

58 delay 30 seconds 

59 vup/in sysdata.config/send icpu 1 THIS TERMINAL IS BEING STOPPED IN 20 SECONDS! 

60 delay 20 seconds 

61 vup/in sysdata.config/kill icpu 1 THIS VDT WAS STOPPED TO REBALANCE THE PROCESSORS... WILL 
BE BACK SOON. 

62 COMMENT: 

63 COMMENT: 

64 comint/in obey.download/ 

65 comint/in obey.splwarm/ 

67 comint/in input.strtwarm/ 

68 comint/in obey.strtaopr/ 

69 comint/in obey.stats/ 

70 COMMENT: 

71 COMMENT: 

72 COMMENT: END OF OBEY FILE TO REBALANCE CPU 1 

Figure 99.1. balcpui Obey File (concluded) 





99.2 











System Management Topics 


System Obey Files 


The CLASDOWN Obey File 

Standard 

Disk File Name: Ssystem.obey.clasdown 

Description: This obey file brings the Advertising system to an 
orderly stop. It sends messages at specified inter¬ 
vals, and then makes a request to Szeus to kill all of 
its advertising descendants. 


1 

vup/in sysdata.config/send 

system c 

System will be going down in 1 min. 

2 

delay 10 sec 



3 

vup/in sysdata.config/send 

system c 

REPEAT:CLASSIFIED IS GOING DOWN IN 50 SEC. 

4 

delay 20 sec 



5 

vup/in sysdata.config/send 

system c 

You have 30 sec to sign off. Please save your work!! 

6 

delay 15 sec 



7 

vup/in sysdata.config/send 

system c 

15 sec left !!! Save your work!!!!!!!! 

8 

delay 15 sec 



9 

vup/in sysdata.config/send 

system c 

This is it!! SYSTEM GOING DOWN !! 

10 

vup/in sysdata.config/stop 

system c 


11 

qrequest htexc;stop system 1 


12 

comjnent End of obey file- Classified is now down! 


Figure 99.2. clasdown Obey File 

1 Substitute your logical system name for htexc to use this obey file on 
your system. 
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The DOWNLOAD Obey File 


Standard 
Disk File Name: 


$SYSTEM. OBEY. DOWNLOAD 


Description: This obey file is called in by the strtcold and 
strtwarm obey files. It may also be run at any time 
you would like to restart the download processes. It 
stops the download processes, and then restarts 
them. 


1 

COMMENT: This OBEY file starts all "download" processes 



2 

COMMENT: SDNF1 for XTM-II SF1 



3 

4 

stop SDNFl 

run sii.downld/name Sdnfl.in Ssystem.sysdata.vdtctrl, out 
nowait,cpu 1/clase 

SO,pri 

89. 

5 

COMMENT: SDNF2 for XTM-II SF2 



6 

7 

stop SDNF2 

run sii.downld/name $dnf2,in Ssystem.sysdata.vdtctrl.out 
nowait,cpu 0/clase 

SO,pri 

89. 

8 

COMMENT: SDNF3 for XTM-II SF3 



9 

10 

stop SDNF3 

run sii.downld/name Sdnf3.in Ssystem.sysdata.vdtctrl.out 
nowait.cpu 1/clase 

SO.pri 

89. 

11 

COMMENT: SDNF4 for XTM-II SF4 



12 

13 

stop Sdnf4 

run sii.downld/name Sdnf4.in Ssystem.sysdata.vdtctrl.out 
nowait,cpu 0/clase 

SO.pri 

89. 


Figure 99.3. download Obey File 
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The EDITDOWN Obey File 

Standard 

Disk File Name: Ssystem.obey.editdown 

Description: This obey file is used to warn all users logged onto 
the editorial system that it will be taken down in one 
minute, editdown stops all econtrol processes, 
and asks $zeus to kill all of its editorial descen¬ 
dants. 


1 vup/in sysdata.config/send system e System will be going down in 1 min? 

2 delay 10 sec 

3 vup/in sysdata.config/send system e REPEAT:EDITORIAL IS GOING DOWN IN 50 SEC. 

4 delay 20 sec 

5 vup/in sysdata.config/send system e You have 30 sec to sign off. Please save 

your work!! 


6 delay 15 sec 

7 vup/in sysdata.config/send system e 15 sec left !!! Save your work !!!!!!!! 

8 delay 15 sec 

9 vup/in sysdata. config/send system e This is it!! SYSTEM GOING DOWN !! 

10 vup/in sysdata.config/stop system e 

11 qrequest htexe;stop system 1 


11 

12 comment End of obey file- editorial is now down! 


Figure 99.4. editdown Obey File 


Substitute your logical system 
your system. 


name for htexe to use this obey file on 
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The KILLTEMP Obey File 

Standard 

Disk File Name: $system.obey.killtemp 

Description: This obey file (for TNS li systems only) may be 
executed whenever necessary. It kills all temporary 
files that are created when a .tns ii system is cold- 
started. 

Line 2: Purges the files Ssystem.system.x, $sys- 
tem.system.xx, Ssystem.system.xxx. 

Line 3: Creates an edit file called “x.” 

Line 4: Executes a comint “files” command that 
lists every file and puts the list in edit file “x”. 

Line 5: Goes into the editor and gets file “x”. The 
results of the edit are placed in the file called “xx”. It 
deletes all occurrences of changes all lines in 
the edit file with “purge" starting at column 1 and 
exits the editor. 

Line 6: Executes a command interpreter that uses 
file “xx” as input. 

Line 7: Purges files “x,” “xx,” and “xxx.” 


1 COMMENT Start o killtemp obey file 

2 purge x,xx,xxx 

3 fup create x,type e 

4 files/out x/* 

5 edit x p xx; dqn/#/a; cql"purge "a; e 

6 comint/in xx/ 

7 purge x,xx,xxx 

8 COMMENT End of obey file. 

Figure 99.5. killtemp Obey File 
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LOGSWAP Obey File 

Standard 

Disk File Name: Ssystem.obey.logswap 

Description: This obey file can be used whenever necessary to 
purge the oprlog. It changes the oprlog, prints 
the old log, and sets the volume and subvolume 
defaults. Sll recommends scheduling this obey file 
for weekly execution to save messages for later 
analysis. 

Figure 99.6 contains the text of an obey file for a tns i system. 


1 COMMENT: To change oprlog and print the oldlog 

2 COMMENT: To set vol.subvol defaults 

3 volume Ssystem.system 

4 COMMENT: To purge the last oldlog 

5 purge oldlog 

6 COMMENT: to rename oprlog to oldlog 

7 rename oprlog,oldlog 

8 COMMENT: to create a new oprlog 

9 create oprlog,50 

10 COMMENT: To switch logging to newly created oprlog 

11 pup console, switch 

12 COMMENT: To print hardcopy of error messages 

13 dumpiog/in oldlog,out $s.#s.slp/ 

14 COMMENT: End of obey file 

Figure 99.6. logswap Obey File for tns i System 

Figure 99.7 contains the text of an obey file for a tns ii system. 


1 COMMENT: To change oprlog and print the oldlog 

2 COMMENT: To set vol.subvol defaults 

3 volume Ssystem.system 

4 COMMENT: To purge the last oldlog 

5 purge oldlog 

6 COMMENT: to rename oprlog to oldlog 

7 rename oprlog,oldlog 

8 COMMENT: to create a new oprlog 

9 create oprlog,50 

10 COMMENT: To switch logging to newly created oprlog 

11 pup console, switch 

12 COMMENT: To print hardcopy of error messages 

13 fup copy oldlog, out Ss. #s.sip,share,no head 

14 COMMENT: End of obey file ___ 

Figure 99.7. logswap Obey File For tns ii Systems 


99.7 






System Obey Files 


System Management Topics 


The ONEM1N Obey File 

Standard 

Disk File Name: Ssystem.obey.onemin 

Description: Warns all users logged onto the system that it will be 
taken down and that they have one minute to log off 
and stops all vcontrol processes. 


vup /in Ssystem. sysdata.config/ send group all 
vup /in Ssystem.sysdata.config/ send group all 
delay 10 sec 

vup /in Ssystem.sysdata.config/ send group all 
delay 15 sec 

vup /in Ssystem.sysdata.config/ send group all 
vup /in Ssystem.sysdata.config/ send group all 
delay 10 sec 

vup /in Ssystem.sysdata.config/ send group all 
delay 15 sec 

vup /in Ssystem.sysdata.config/ send group all 
vup /in Ssystem.sysdata.config/ stop group all 


The system will be going down 
in 1 minute 

PLEASE SAVE WORK AND LOG OFF 


The system will be going down 
in 45 SECONDS 


The system will be going down 
in 30 SECONDS 

PLEASE SAVE WORK AND LOG OFF 


15 SECONDS TO SIGN OFF!! 


It's going, it's going!!! 
SYSTEM WILL BE BACK later 


Figure 99.8. onemin Obey File 
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Standard 
Disk File Name: 

Description: 


SECURE Obey File 

SSYSTEM.OBEY.SECURE 

This obey file can be used whenever there are files 
that need to be secured. It secures the specified 
files. 


1 

volume Ssystem.sii 


2 

fup give data.254.254 


3 

fup give qume.254,254 


4 

fup secure data. "NCNC", PROGID 


5 

fup secure qume, "NCNC". PROGID 


6 

fup license proof 


7 

fup give econtrol,255,255 


8 

fup give econtrol.255,255 


9 

fyp secure econtrol, "NCN-", PROGID 


10 

fup secure econtrol. "NCN-\ PROGID 


11 

fup license econtrol 


12 

fup license econtrol 


13 

fup license ci 

* 

14 

volume Ssystem.system 


15 

fup secure gloss. "NCNC". progid 


16 

fup give gloss,255.255 


17 

fup license spoolcom 


18 

fup secure spoolcom, "NNNC". PROGID 


19 

fup give spoolcom.255.255 


20 

COMMENT: End of Obey File SECURE 



Figure 99.9. secure Obey File 



The SPLCOLD Obey File 

Standard 

Disk File Name: Ssystem.obey.splcold 

Description: This file is called in only by the strtcold obey file. 

It purges the old spooling file, and creates a new 
one, starts the spooling supervisor Sspls, and exe¬ 
cutes spoolcom to create the spooling system envi¬ 
ronment and start the spooling collectors. 


1 COMMENT To cold start only the spooling system 

2 fup purge ! Ssystem.spl.* 

3 create Ssystem.spl.data.200 

4 spool in Ssystem.spl.spl. out SO. name Sspls. pri 170. nowait. 

cpu 1/0.200.400.11.10.10 

5 spoolcom /in Ssystem.obey.splconf 

' 6 COMMENT End of Obey File SPLCOLD 

Figure 99.10. splcold Obey File 
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The SPLCONF Obey File 


Standard 
Disk File Name: 

Description: 


SSYSTEM. OBEY. SPLCONF 


This obey file is called by the strtcold obey file. It 
configures the spooling environment and starts the 
collector. 

Line 1: Starts the collector called $s. 

Lines 2 - 4: Starts 3 print processes. 

Lines 5-10: Maps devices with print processes. 
Lines 11 - 24: Maps locations with devices. 

Line 25: Starts the spooler. 

Line 26: Exits spoolcom. 


1 

collect 

Ss.file system.cspool, cpu 1 .backup O.data Ssystem.spl.data.pri 155 


2 

print 

Ssplp.file Ssystem.system.pproc.cpu O.pri 169.backup 1 


3 

print 

Sjobs. file sii.jobs.cpu 1. pri 146 


4 

print 

Srprt, file sii.jobs.cpu 0, pri 146 


5 

dev 

Sip.speed 200, process Ssplp. fifo. header on 


6 

dev 

Squmel,speed 30.parm 4.process Ssplp.fifo.header off 


7 

dev 

Sslp,speed 120.process Ssplp. fifo. header on 

% 

8 

dev 

Soki.speed 120.process Ssplp.fifo.header off 


9 

dev 

Sj. speed 450. process Sjobs, fifo. header off 


10 

dev 

Srp. speed 450. process Srprt. fifo. header off 


11 

loc 

#data.tandem.dev Sj 


12 

loc 

#data.report.dev Srp 


13 

loc 

#data.default . dev Sj 


14 

loc 

#s.Ip. dev Sip 


15 

loc 

#lp.default.dev Sip 


16 

loc 

#default.Ip, dev Sip 


IT 

loc 

#s.sip. dev Sslp 


18 

loc 

#slp.default. dev Sslp 


19 

loc 

#default.slp . dev Sslp 


20 

loc 

#s.oki . dev Soki 


21 

loc 

#defauit.oki. dev Soki 


22 

loc 

#oki.default . dev Soki 


23 

loc 

#qume.default. dev Squmel 


24 

loc 

#qume.system, dev Squmel 


25 

SPOOLER.START 


26 

EXIT 




Figure 99.1 1. splconf Obey File 
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The SPLWARM Obey File 


Standard 
Disk File Name: 


Description: 


SSYSTEM. OBEY. SPLWARM 

This obey file is called by the strtwarm obey file. It 
Warm starts the spooler saving the contents of the 
data file spl.data 


1 COMMENT Warm start the spooling system no lost data 

2 stop Sspls 

3 stop Ss 

4 spool /in Ssystem.spl.spl.out SO. name Sspls, pri 170. nowait.cpu 1/0 

5 spoolcom spooler.start 

6 COMMENT End of Obey File SPLWARM 

Figure 99.12. splwarm Obey File 


The STARTUP Obey File 


Standard 

Disk File Name: Ssystem.obey.startup 


Description: 



After the system has the cold loaded (a command 
interpreter has been started on the osp (tns ii) or 
Stermi (tns i), this file reloads all processors that 
are to be reloaded, creates a backup process for the 
command interpreter, runs Scmon, starts xraycom 
with the lights option, starts the pup logging console, 
and creates any command interpreters that are also 
to be run. 


Figure 99.13 contains the text of an obey file for a two-processor tns ii 
system without a hardcopy console and one Operations and Service Pro¬ 
cessor (OSP). 


1 COMMENT: This is a TNS II obey file 

2 altpri SzOOO,199 

3 reload 0 

4 reload 1 

5 backupcpu 1 

6 backupcpu 0 

7 run sii.del temps 

8 set inspect on 

9 cmon /name Scmon. in Ssystem.sysdata.cmon. out SO. pri 149. nowait 

10 lights 

11 imon /name Simon.nowait, cpu 0 12 pup console SOSP.on 

13 COMMENT: END OF STARTUP OBEY FILE 


Figure 99.13. startup Obey file for Two-Processor tns ii System 
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Figure 99.14 contains the text of an obey file for a two (2) processor tns 
i system with one hardcopy console and one operator terminal (a Tandem 
6520 or 6530). 


1 

COMMENT: STARTUP OBEY FILE ! 

2 

altpri SzOOO.198 


3 

reload 0, Ssystem 


4 

reload 1, Ssystem 


5 

backupcpu 1 


6 

backupcpu 0 


7 

run sii.deltemps 


8 

cmon /name Scmon, in sysdata. cmon. out $0, pri 176, nowait,cpu 0/ 

9 

lights 


10 

imon /name Simon,nowait,cpu 0/ 

11 

set inspect on 


12 

COMMENT: END OF OBEY 

FILE STARTUP 


Figure 99.14. startup Obey file for Two-Processor tns i System 



The STOPALL Obey File 


Standard 



Disk File Name: 

Ssystem.obey.stopall 


Description: 

This obey file should be run after Szeus has 
stopped all of its descendants, stopall stops all 
processes remaining except Szooo. 

Line 1 - Purges the files Ssystem.system.x, Ssys¬ 
tem.system.xx, and Ssystem.system.xxx 



Line 2 - Creates a file called Ssystem.system.x to be 
an edit type file. 



Line 3 - Executes a ppd listing, and puts the listing 
in file “x.” 



Line 4 - Edits x, putting the results in xx. Deletes the 
first two lines of the ppd listing. Changes columns 9 
through 80 with nothing. Changes Szooo with noth¬ 
ing. Changes all occurrences of “S” with “stop S.” 

Exits the editor. 

Line 5 - Executes the command interpreter using 
the file xx as its input file. 

1 purge x 

,xx.xxx 


2 fup create x.type e 


3 ppd/out x/ 


4 edit x 

p xx: dql/2; cq9: 80""a: cq"SZ000'"'a: cq"S"stop S"a: e 

5 comint 

in xx/ 



Figure 99. 1 5. stopall Obey File 
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The STRTWARM Obey File 


Standard 
Disk File Name: 

Description: 


SSYSTEM.OBEY. STRTWARM 

At coldstart time, after the startup obey file, this 
obey file is used to preserve the jobs in the spooler. 
strtwarm stops any processes that may be run¬ 
ning, starts the message broadcasting system 
Saopr, warm starts the spooling system, starts the 
download process $dna, starts the econtrol statis¬ 
tic process Sstat, and starts Szeus, which in turn 
starts its descendants. 


2 

3 


8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 


NOTE ARE YOU LOGGED ON AS SUPER.SUPER? 
stop Szeus 
stop Sspls 
stop Ss 
stop Sjobs 
stop Srprt 
stop Sdna 
stop Sdnv 
stop Sstat 
stop Sschd 

COMMENT: WARM START THE INPUT SPOOLERS 
comint /in input.strtwarm/ 

COMMENT: START APPLICATIONS OPERATOR MESSAGE LOGGING PROGRAM 
comint /in obey.strtaopr/ 

COMMENT: START THE DOWNLOAD PROCESSES 
comint /in obey.download/ 

COMMENT: WARM START THE SPOOLING SYSTEM 
comint/in obey.splwarm/ 

COMMENT: LOGON AS TANDEM USER 254.255 TO RUN REST OF PROCESSES 
logon sii.super 

COMMENT: START THE STATISTIC PROCESSES 
comint /in obey.stats/ 

COMMENT: RUN SZEUS - SYSTEM SUPERVISOR 

run sii.super out SO. name Szeus. pri 165.nowait.term Sosp none 


Figure 99.19. strtwarm Obey File 
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The Daily Status Check Obey File 

Standard 

Disk File Name: $system.obey.daystat 

Description: This obey file performs general daily system status 
checks. 


1 COMMENT: GOOD MORNING SYSTEM MANAGER 

2 COMMENT: SYSTEM STATUS CHECK - TO EXECUTE DAILY 

3 PUP LISTDEV 

4 delay 10 sec 

5 COMINT / IN OBEY.PEEK / 

6 PUP LISTFREE SSYSTEM.HIST 

7 PUP LISTFREE SSYSTEM,HIST,1000,2000,5000, 7000, 10000 

8 DSAP SSYSTEM, FREESPACE 

9 delay 2 sec 

10 PUP LISTFREE SDATA.HIST 

11 PUP LISTFREE SDATA,HIST,1000,2000,5000,7000, 10000 

12 DSAP SDATA, FREESPACE 

13 delay 2 sec 

14 PERCENT 

15 FUP INFO SDATA. EDITOR.HEADER, STAT 

16 delay 2 sec 

17 NETMON PROBE 

18 PUP LISTDEV TYPE 63 

19 delay 2 sec 

20 SPOOLCOM /IN OBEY.SPLSTAT/ 

21 delay 5 sec 

22 SPOOLCOM / IN OBEY.INSTAT/ 

23 delay 5 sec 

24 B STATS 

25 ielay 2 sec 

26 COMMENT: HAVE A NICE DAY, SYSTEM MANAGER._ 


Figure 99.20. Daily Status Check Obey File 


The Daily Output Spooler Status Check Obey File 

Standard 

Disk File Name: Ssystem.obey.splstat 

Description: This obey file performs general daily spooling sys¬ 
tem status checks. It is called from the 
OBEY.DAYSTAT obey file and contains SPOOL¬ 
COM commands. 


1 

COLLECT 


2 

PRINT 


3 

DEV 


4 

LOC 

_ . /-m _i. 


Figure 99.21. Daily Output Spooler Status Check Obey File 
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The Daily Input Spooler Status Check Obey File 


Standard 
Disk File Name: 


SSYSTEM.OBEY.INSTAT 


Description: This obey file performs general daily wire input 
spooling system status checks. It is called from the 
OBEY.DAYSTAT obey file and contains SPOOL- 
COM commands. 


1 OPEN $ISPL 

2 COLLECT 

3 PRINT 

4 DEV 


Figure 99.22. Daily Input Spooler Status Check Obey Fiie 


The STATS Startup Obey File 

Standard 

Disk File Name: Ssystem.obey.stats 


Description: This obey file runs the statistics collection process¬ 
es. It is called from the OBEY.STRTWARM or 
OBEY.STRTCOLD obey file. (Note: If a site is using 
VSTAT, they will not use this file.) 


run Sdata.sii.gstat / name Sostat, out Ssystem.editor.olstat, nowait, pri 148. cpu 1/ 

run Sdata.sii.gstat / name Sistat, out Ssystem.editor.ilstat. nowait, pri 148. cpu 0/ 

run Sdata.sii.gstat / name Sesta. out Sdata.editor.vdtstat. nowait, pri 148. cpu 1/ 

run Sdata. sii.gstat / name Sesta. out Sdata.class.vdtstat. nowait, pri 148. cpu 0/ 


Figure 99.23. stats Startup Obey File 
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SUBJECT: CPU Halts 

SUPERSEDES: N/A 


DATE: 08/01/85 

PUB. # 55B-0090 


ft 


Procedures During a CPU Halt 

This bulletin describes the steps which should be followed when a tns ii 
or txp processor fails. 

1. First, write down the following information for the affected processor: 

a. whether or not the front panel power light is on 

b. whether or not the front panel run light is on 

c. the value displayed in the front panel lights (write down the bit 
numbers if necessary) 

d. the message on the status line (25th line) of the osp 

2. Press [shift] and [El] on the osp keyboard to get the System Proces- 
sors Status display (Figure 55B-0090.1). 


OSP - 9938B00 - (28JAN85) 


P# STATUS T POLL 
2 


SYSTEM PROCESSORS STATUS 
P# STATUS T POLL P# STATUS T POLL 


P# STATUS T POLL 


00 ..R. . 

04 . 

08 . 

12 . 


1 

0 

0 

0 


01 ..R. 
05 
08 
13 


02 ..R. 
06 
09 
14 


03 . .R. . 1 

07 . 

10 . 

15 . 


H - halted D - DDT system halt request R = reset enabled E = parity error 

P = processor system halt request 


Type: 


1 = Nonstop II 


2 = Nonstop TXP 


Figure 55B-0090.1. System Processors Status Display. 



The poll field of the status display indicates whether the processor is in 
the poll list (the list of processors “watched” by the osp). In Figure 55B- 
0090.1, processors oo to 03 are in the poll list; processors 04 to 15 are not. 

The t ( type) field indicates whether the processor is a tns ii or txp 
processor. In Figure 55B-0090.1, processors oo to 02 are txps, and pro¬ 
cessor 03 is a tns ii. 

The status field displays the five status bits for each processor. Each 
field may contain a period (condition is not true) or letter (condition is true). 
In Figure 55B-0090.1, the reset enabled condition (r) is true for each 

processor in the poll list. Make a note of any unusual status bits (bits other 
than “FI”). 
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3. Press IshiftI and [fU on the osp keyboard to get the Processor Status 
display (Figure 55B-0090.2 and 55B-0090.3). _ 

Nonstop TXP PROCESSOR 02 STATUS FROM DDT 

Switch setting for Cold Load or Dump: 100000 

Current Processor Status: 

Executing 

Figure 55B-0090.2. TXP Status Display. 

NonStop II PROCESSOR 03 STATUS FROM DDT 

Switch setting for Cold Load or Dump: 100000 

Current Processor Status: 

Executing 

RMD Address: 21376 R® Address: 21547 

Current Channel Status: __ 

Idle loop waiting for processor request or 1/0 reconnect^ CCSD^DR- .0103^ 

Figure 55B-0090.3. TNSII Status Display. 

If the status information displayed is not for the failed processor switch 
to the desired processor by entering the desired cpu number in the ,ie.d on 
the top of the form, and pressing ED on the osp keyboard. 

Check the Current Processor Status field. Write down exactly what it 
savs If the status is “Executing”, the processor is running (though it may 
also be looping and thus malfunctioning). The osp User Guide gives a 
detailed list of the possible processor state messages. These messages 
fail into two general classes: software related and hardware rela e . 

The most important software message is “System freeze instruction 
executed.” This indicates that the processor failed an internal consistency 
check. A memory dump should always be taken when this message is 
loqqed Without a memory dump, Sll will be unable to determine why 
consistency check failed. The only other time that a memory dump » 
indicated is if the processor has been declared down the by rest of the 
system, but the status is “Executing” (indicating a looping processor). 

Virtually all other messages indicate a hardware problem. Sometimes a 
halt number is displayed in the front panel lights (for example, if the 
message is “Halt instruction executed”). At other times the front pane 
liqhts contain no significant information (for example if the message is 
“Parity error has frozen processor"). Parity errors are the most frequen 
hardware problem. The osp User Guide gives detailed information about 
the various parity errors and the most likely cause of the error. 

If you are unsure whether you have a hardware or software problem, 
don’t do anything. Instead, leave the processor down and contact Sll for 
further instructions. If this is unacceptable, get a memory dump and at¬ 
tempt to reload the processor. 

Remember: write down anything unusual. 
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SECTION 100 

System Shutdown/Coldstart 
Procedures 

This section covers the procedures for performing a logical system 
shutdown and subsequent coldstart. Obey files mentioned in this section 
are found in Section 99 of this manual. 

Logical System Shutdown 

1. Notify all users that the system will be going down. 

:o obey.onemin 

Modify the “will be back” message; vup send group “all" (see Section 
94). 

2. Stop all users 

vup stop group* 1 'all'' 
or 

vup stop ‘'system e' 1 

or 

vup stop *‘system c'' 

3. Take down system processes 

request $zeus 
? i2, 11 \siie ’ ' 

4. Drain Spooler 
spoolcom spooler,drain 

5. Stop all remaining processes 
o obey.stopall 

Execute ppd to make certain only $2000 is still running. 

PPD 

6. Refresh 

pup refresh 
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System Startup 

1. Reset all cpus 

2. Load the operating system from disk to one cpu. Procedures are de¬ 
scribed in the following pages. 

3. After loading the operating system, from the Sosp: 
settime (DD MM YY), (HH: MM) 

for example: 

settime 10 sep 1983,10:45 

4. Execute the STARTUP obey file: 
o $system.obey.startup 

5. Execute the strtwarm or strtcold obey file: 
o $system.obey.strtwarm 

or 

o obey.strtcold 

6. When most processes are up request $zeus to start vcontrols if 
necessary. 

request $zeus 
? il 

Loading Operating System Image 

When a system is coldstarted from the operator panel, bit 7 in the Switch 
Register must be set to zero (off). 

If switch 7 is set on, the processor begins to execute a low-level mainte¬ 
nance program called lobug and then freezes. If you accidentally invoke 
LOBUG, press 0 followed by IReturnI . to resume the coldstart. 

1. Set all 16 Switch Register switches on the front panel of the selected 
processor to the down position. 

1. Select the processor from which to begin the cold-load operation. This 
processor must be physically connected to a terminal (for the startup 
comint process) and a disk drive on which the Operating System 
image is located. 

3. You must specify from the front panel switches on the selected cpu 
which disk controller, disk, and operating system to use, and which 
terminal Szooo will come up on. For example, controller %1 and disk 
drive 0. Specify the disk and subvolume to be used by setting the 

Switch Register bits as follows: 

bus contents 

0 ° . 

1-6 System subvolume number of operating system image to be 

loaded (SYSnn) 

7 0 (unless lobug is requested) 

8-12 disk controller 

13-15 disk drive plug or unit number 

4. Turn the reset/load key to the reset position then to the load posi¬ 
tion. 

5. Check for successful completion of the cold load. 

If the load is successful, %i mu is displayed (all lights on). 
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If the load is unsuccessful, the displayed value is an error number (de¬ 
scribed under “Cold Load Errors” in the Tandem Pocket Guide), and the 
processor halts. 

6. After a successful load, the operating system creates a startup comint 
process. 

If the startup comint process is successfully created, the value 
%i 25252 is displayed (in binary 1 010101010101010 ). 

If the comint process is not created, an error number appears in the 
Switch Register and the processor halts. (See “Processor Halts” in the 
Tandem Pocket Guide for the error values.) 

7. After the value %i 25252 appears in the Switch Register, specify the 
logical device number (ldev) of the terminal (or the osp) with which the 
startup comint process is to communicate. 

a. First enter this logical device number into the Switch Register. 

b. Then toggle the switch for bit 0 in the Switch Register. If this 
operation is successful, %i 77777 will appear in the Switch Regis¬ 
ter display. You should now have the command interpreter prompt 
on the terminal. 

The command interpreter has the super.super user (255,255) 
logged on. The default volume is Ssystem.system. 

A display of %052525 indicates that the specified logical device 
does not represent a terminal. Return to step 7a and enter a 
correct number. 

Console messages are directed to the hard-copy terminal with the 
lowest logical device (ldev) number. If no hard-copy terminal is 
connected to the system, console messages are directed to the 
terminal with the lowest ldev number other than the osp. 

8. It is necessary to prime all the remaining opus so they can be loaded 
over the dynabus by reload commands in the obey.startup obey 
file. 

Do this for each of the remaining processors: 

a. If the system contains tns 11 or txp processors, set switch register bit 0 
to one and bits 1 through 15 to 0. 

If the system contains tns i processors, set switch register bit 0 to 1 
and bits 1 through 15 to the octal cpu number for the given processor. 

b. Turn the reset/load key first to reset position, then to the load 
position. 
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SECTION 101 

System Balancing 

The Purpose of Tuning and Balancing 

The purpose of tuning and balancing the System/55 is to distribute 
system workload evenly among all of the available resources in order to 
obtain optimum system performance. 

Tuning and Balancing: A Definition 

Tuning and balancing consists of a cycle of operations where various 
data is gathered and analyzed and corrective steps are taken until all 
components of the system are sharing the workload evenly. It is important 
to note that tuning and balancing is a process that never ends. As new 
hardware is added to the system and the system load changes, balancing 
is generally required to maintain optimum performance. The complete 
cycle is illustrated in Figure 101.14 at the end of this section. 

The three most serious system problems, in order of importance, are: 

1. High swap activity in a cpu 

2. High disk activity in a cpu (measured by metering a disk process 

primaried in the cpu) 

3. An over-busy cpu (indicated by a long dispatch queue) 

Basic Definitions 

xray—xray is a Tandem software/firmware tool for monitoring the per¬ 
formance of the System/55. 

xraycom—xraycom is a Tandem utility that allows you to configure, start, 
and stop a measurement. When xraycom is run on a particular 
system, it creates, in each local processor, a process known as the 
“recorder.” The recorders allocate and initialize measurement count¬ 
ers in their cpu. As the measurement proceeds, the operating system 
records significant events in the counters. Once a measurement is 
started, the recorder in each processor periodically copies the current 
values of all of the configured counters to an unstructured disk file, 
called the data file. 

xrayscan—xrayscan is a Tandem utility run against the data file to 
analyze the collected data, xrayscan has a set of commands that 
allow you to examine measurement data in the form of tables or time 
plots. If desired, xrayscan can be run while a measurement is in 
progress, allowing online analysis of the system's performance. 

busy stats —These are statistics dumped on request by each logical 
systems god (egod, editorial; cgod, advertising) process. For each 
god server, statistics are collected and dumped on request. These 
statistics show total number of requests serviced; total time to service 
all the requests; average time to service each request; and average 
queueing delay for each request, god servers are specified in the 
configuration file as process type 3. 
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vdt stats —These are statistics collected by an Sll statistics collector. 
These statistics show response times for explicit vdt transactions and 
various virtual requests. 

pup listdev— This printout is produced by the Tandem utility pup. It 
shows the primary cpu for each controller in the system. 

directory extracts —These are directories that use a data file that is an 
extract of the header file. The record size of the data file is much 
smaller than that of the header file and therefore more records can be 
read and displayed with fewer disk reads. The net effect is faster 
directories and less disk i/o. 

swap rate— The swap rate is the average number of virtual memory 
pages swapped in or out of memory per second. Processes page 
fault when there is not enough main memory to satisfy their needs. 
The time spent by the virtual memory manager swapping code and 
data pages in and out of me'mory is time taken away from the applica¬ 
tion processes, and the i/o processes that service them. It is impera¬ 
tive that virtual memory management be kept to an absolute 
minimum. 

disk rate— This is the average number of input and output disk transfers 
per second on the processors i/o channel. 

cpu qlen —This is the average length of the processor queue. This in¬ 
cludes all processes on the ready list, including the one running and 
those waiting for virtual memory. 

cpu busy— This is the percentage of time that the processor was in use, 
either executing a program or handling interrupts. 

recv QLEN— Although this applies to any process, we use it mainly to 
monitor disk processes. This is the average number of messages in 
the message input queue to the process, measured only over the time 
that the process was executing in the processor. 

Step 1: Balancing I/O and Processes 

Before actually XRAYing the system, you will need to do some basic 1,0 
balancing and process distribution. 

Process Distribution 

Process distribution is concerned with the vcontrol processes—the 
editorial vdt process (econtrol) and the classified vdt process 
(ccontrol). It is very important that there no more vcontrol processes 
running than there are physical vdts. A vcontrol processes with no 
associated vdt will still use cpu time and memory. It is highly recom¬ 
mended that for each logical subsystem, the vcontroL processes be 
evenly distributed between all available cpus. There are two reasons for 
this: It gives you a good start on balancing the cpu load and, in the event of 
a cpu failure, a minimum number of vdts will be affected. The Sll utility 
vdtgen (see Section 93) performs this function. 

Balancing I/O 

Balancing i/o involves spreading the vpend files evening across all 
available disk volumes (using vdtgen) and, using pup to primary devices 
to proper cpus so that i/o is balanced. The devices we are most concerned 
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with are disks, ftms and xtms, and vcus and tcus. The main goal is to 
primary the devices so that each cpu is handling its share of i/o. As a 
guideline we can assume that a disk process will generally contribute 
about 15 percent to the cpu busy; the ftm/xtm and tcu/vcu about 5 
percent. 

Some additional guidelines: 

1 . No more than one disk volume should be primaried to any one cpu. 

2. The disk process should generally be primaried to the even-numbered 
cpus. Unless there are two volumes between two cpus then an odd- 
numbered cpu will be controlling a disk volume. 

3. Since a disk volume contributes heavily to the cpu load, the cpus that 
control disks should control fewer ftms, xtms, tcus, or vcus. 

When your system was initially configured, i/o balancing was a primary 
consideration. Therefore, when your system is cold loaded, the sysgen 
should automatically primary devices so the i/o is balanced. 

Step 2: Check Process Priorities 

Before XRAYing the system, check process priorities to make certain 
they are set to a level recommended by Sll. 

The recommended process priorities are listed below. The priorities for 
some of the processes listed below are specified in the configuration file. 
Priorities for processes not found in the configuration file are described in 
theCMON data file. 



Table 101.1 


Process Priorities 

PROCESS 

RECOMMENDED PRIORITY 

AOPR 

190 

b (busy) 

174 

BACKUP 

125 

BURSTER 

145 

CMON 

176 

COMINT 

175—except for $zooo which should 
run at 198 

cupdateh (ad header update 160 

process) 

CARBON 

CCONTROL (see VCONTROL) 

85 

Scgod (advertising system 
overseer) 

164 

data output module 

100—alternate of 110 with threshold 
of 5 

Default 

1 

65 
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Table 101 

.1 (continued) 

Process Priorities 

PROCESS 

RECOMMENDED PRIORITY 

DOWNLD/VDISC 
econtrol (see VCONTROL) 

85 

EDIT 

125 

egod (editorial system overseer) 

160 

FGEN 

130 

fio (file i/o process) 

156 

FILTER 

135 

FIXCHAR 

130 

FMOD 

125 

FSTAT 

195 

FUP 

125 

GLOSS 

125 

headfit justification process 

120 

HYPHEN 

115 

INMON 

146 

INSAVE 

103 

INTAKE 

134 

JUST 

105 

LGEN 

130 

MESSAGE 

145 

OUTMON 

146 

OUTPUT MODULES 

90_ a ltemate of 95 with threshold of 

10 

OUTTAKE 

103 

PAGED 

130 

PD 

130 

PEEK 

195 

PROOF 

90—alternate of 95 with threshold of 

10 

PSTAT 

195 

PUP 

125 

PURGE 

10 

Q 

125 

RCVR 

145 

READYQ 

195 

REQUEST 

174 

RESTORE 

125 

RGEN 

70 

s (spooler collectors) 

155 

SAVE 

100—alternate of 110 with threshold 
of 10 

SCAN 

125 

SCHED 

145 

SCHEDSET 

125 

SPELL 

50 

$splp (spooler print process) 

169 

$spls (spool supervisor) 

170 

SPOOLCOM 

125 

STATS 

145 

TEXTR 

155 
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Table 101.1 (continued) _ 

Process Priorities 

RECOMMENDED PRIORITY 


PROCESS 

TEXTW 

updateh (editorial header update 

process 

VCONTROL 


VPUTGET 

VUP 

wtake (wire collection) 
Szeus (super) 


160 

160 

140—139 and 141 are reserved; 
vcontrols automatically raise 
their priority by one during inter¬ 
active H&J and lower their prior¬ 
ity by one when constructing a 
sorted directory 
150 
174 
80 
165 


. Step 3: Collecting Basic XRAY Data 

Collecting the basic xray data involves using the Tandem utility xray- 
com to start a measurement. Before actually running xraycom, we must 
first create a data file for recording the measured data. 

To do this, follow the steps below: 


1. Pick a disk volume that has enough space to store the data file. 

2. Use fup to create the data file as follows: 


fup executes the utility 

set ext (500, 500) sets the extent sizes 

create Svol.xray.dxxyy 

exit 


Figure 101.1. Creating a File to Store xraycom Data 


In Figure 101.1, $vol is the disk volume selected to store the data, xx is 
the month and yy is the day. For example,if you are creating an xray data 
file on Ssystem on January 10, the data file name will be Ssystem.xray.- 
oi io. This naming convention will allow us to store many xray data files 
and track them by day. 

We must next create an xray configuration file that specifies the entities 
we want to measure. To do this,follow the steps below. 

1. Use the Tandem edit utility to create a new configuration file called 
Ssystem. xray. xconf. 

2. The entries in the file should be: 


Devices: 


Programs: 


Ssystem 

Sdata 

Sdatal 

Sdata2 (and so 
are specifiedi 
sysprocs 


on until 


all disk volumes 


This configuration file will measure all the disks and all the system 
processes. 
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Once you have created the data file and the configuration file, you can 
begin measurement with the xraycom utility. Note that xraycom should 
be run in cpu o and that the use of the comint settime command during 
measurements invalidates the measurement data and may have otherwise 
unpredictable results. 

Execute xraycom in cpu o -and enter the commands as illustrated in 
Figure 101.2. The prompt for this utility is a plus sign ( + ). 

:xraycom/cpu 0/ 

+ data Svol.xray.dxxyy 

the name of the data file created above 

+conf Ssystem.xray.xconf 

the name of the configuration file created above 

the time interval the data is written to the data file. The measurement is not started until this 
command is issued. 

+ exit exits the utility ______ 

Figure 101.2. Commands to start xray Measurement 


The Tandem utility xrayscan is used to produce reports on the data 
collected with xraycom. Assume that we have determined that between 2 
pm and 4 pm is a heavy activity period. 

To examine the data for that time period, we run xrayscan as illustrated 


in Figure 101.3. 


xrayscan/out $s. #loc/$vol.xray.dxxyy . . 

Svol.xray.dxxyy is the name of the data file created above and Ss.#/oc is the print loca¬ 
tion 

+ window 14: 00, 16: 00 
specifies the measurement window 

+ cpu 

reports on measured processors 

■4.process, by cpu busy, if cpu busy > 1 

reports on all measured processes sorted by cpu busy and only lists those with cpu 
busies greater than 1 
+process,by recv rate 

reports on all measured processes sortedloy recv rate;used for checking the disk pro¬ 
cesses 

+process,by recv qlen 

reports on all measured processes sorted by recv qlen;used for checking the disk pro¬ 
cesses _ ___ 


Figure 101.3. xrayscan Commands to Produce Reports of Collected Data 


Step 4: Collecting the GOD Busy Statistics 

The egod and cgod processes automatically collect statistics about 
each of their servers. You need only initialize the statistics and dump them 
at the end of your measurement interval. 

You must first pick a period of time during which the system will be 
heavily used. This might be from 11 am to 12 pm or from 2 pm to 4 pm and 
could vary for each logical subsystem. Assume that you have determined 
the busy period for the editorial system is between 2 pm and 4 pm. At 2 pm 
use the request process as illustrated in Figure 101.4 to initialize the 

statistics for Segod. 
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;request $egod 
00,023;? il4 
00,023;? EOF! 

00,023;Process;? EOF! 


Figure 101.4. Initializing Segoo Statistics Collection Process 

At 4 pm, use the b (busy) process to dump the statistics that have been 
collecting since 2 pm. 


b/out $s.#loc/stat 

#/oc is the location to which the printout will be sent 

Figure 101.5. Dumping Statistics Collected by Segoo 


A typical statistic is illustrated in Figure 101.6. 


Process:SEAJ1 Server class:APSJ 

Requests: 101 Time: 719. 48 Average: 7. 12 + 0.00 

Figure 1 01 .6. Statistic for Segoo Server Process {Seaji ) 


requests —The total number of requests serviced by this process. 
time —The total time used to service the requests. 

average —The average time to service each request. The number follow¬ 
ing the plus sign is the average queueing delay. This is the amount of 
time each request was in the queue before it was processed. 


Step 5: Collecting VDT Statistics 

Although vdt statistics are not needed to tune and balance a system, 
they are helpful in determining whether your balancing efforts are improv¬ 
ing response times. 


In order to produce vdt statistics, a statistics collector must be running 
for each vdt process. Two types of statistics collectors are available. 

gstat is a general purpose statistics collector. This collector requires an 
rgen report to list the data, which may require up to 45 minutes to run. 
However, it produces reports that show what each signed-on user did on 
the system. 


vstat can only be used to collect vdt statistics. With this collector you 
can reset the statistics on demand and print them out in just a few sec¬ 
onds. You cannot produce reports showing what each signed-on user did 
on the system. Since we are interested in obtaining statistics quickly during 
different time periods, we will only discuss the use of the vstat statistics 
collector. 


The statistics collector is entered in the configuration file and is started 
by $zeus. A typical configuration file entry for the vstat process is illustrat¬ 
ed in Figure 101.7 on the following page. 
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System E Record Type 0_ Process type 2_ Record #999 

Process Name SESTA _ 

Program File Name $SYSTEM.SII.VSTAT _ 

Primary CPU _ Alternate CPU _ Available CPUs _ 

Priority 145 Alt Priority _ Threshold _ Server 

Server Class STAT Reference Name _ 

Home Terminal _ Rund _ 

Input File Name _ 

Output File Name _ 

Parameter String _ 


Figure 101.7. Configuration File Record for vstat Process 

A second configuration file entry is required to tell the vdt processes the 
name of the statistics collector to open. 

This configuration file record is illustrated in Figure 101.8. Note that the 
process name and program file name in this record must be the same 
as the process name specified in the configuration file entry for the vstat 
process. 


System E Record Type 16 Process type 0_ Record #999 

Process Name SESTA _ 

Program File Name SESTA ___ 

Primary CPU _ Alternate CPU _ Available CPUs _ 

Priority 145 Alt Priority _ Threshold _ Server _ 

Server Class STAT Reference Name _ 

Home Terminal ___ Rund _ 

Input File Name __ _ . _ 

Output File Name __ 

Parameter String ____ 


Figure 101.8. Configuration File Record for vstat Process 

If you make these configuration file entries while the system is operat¬ 
ing, you will need to stop and restart all vdt processes. This can be 
accomplished with vup kill or by shutting the system down and executing 
the strtwarm obey file. 

VDT statistics will be most meaningful if they are collected during the 
same period of time that xray is running and god statistics are collected. 
Assume you want to collect data from 2 pm to 4 pm. At 2 pm you must run 
the utility dstat to initialize the statistics collector. The procedure is illus¬ 
trated in Figure 101.9. 


;DSTAT 

executes the program 
*stat SESTA 

specifies the name of the statistics collection process 
♦clear 

clears all statistics 
♦exit 

exits the program 

Figure 101.9. Initializing the Statistics Collector with dstat 
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At 4 pm you must execute dstat again to dump the statistics that have 
been collecting since 2 pm. 

;DSTAT 

executes the program 
*stat SESTA 

specifies the name of the statistics collection process 

*out $s. #loc 

dumps the collected statistics 

*exit 

exits the program 

Figure 101.10. Dumping the Statistics Collected with dstat 


Step 6: PUP L1STDEV 

The main reason for getting a pup listdev each time you make a 
measurement is so you can be certain that the i/o devices are still primar- 
ied to the desired cpus. If a disk drive should switch to another cpu during 
a measurement period, and you do not know about it, you could easily 
make some false conclusions about the system balancing. 

To obtain a pup listdev, simply execute the Tandem Utility pup as 
illustrated in Figure 101.11. 


pup/out Ss. #loc/ listdev $s.#loc is the print location 

Figure 101.11. PUP LISTDEV Command 

STEP 7: Running CONFIG CPUS 
and CONFIG VDT Reports 

The config cpus and config vdt reports are very useful for determin¬ 
ing which cpu each process is running in. The reports read through the Sll 
Configuration file and list the processes for each cpu. The config cpus 
report lists all processes other than econtrol and ccontrol programs 
and the config vdts lists only the econtrol and ccontrol programs. 

Each report should be stored in a take in the system with an appropriate 
name (for example, “config cpus” for the config cpus report and “config 
vdt for the config vdt report) The text of the reports is illustrated in 
Figures 101.12 and 101.13. 


volume Ssystem 

rgen /out Ss. #config.xcpus/x, sysdata.config, list 
detailfile sysdata.config 

reject god~id o^x’’ or proc~type = 4 or proc'type = 0 or 
rec'type > 0 

sort by cpu by alt^cpu by proc'type by class‘name 

list by cpu alt cpu avail cpus class'name server'pri proc'name 

priority 

prog^name 

Figure 101.12. Text of config cpus rgen Report 
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volume $system 

rgen /out $s. #config.xcpus/x, sysdata.config?list 
detailfile sysdata.config 

select gocTid = ' *x' f and proc*type = 4 and reef type = 0 

sort by cpu by alt'cpu by prototype by class~name 

list by cpu alt^cpu avail^cpus class^name server^pri procfname 

priority 

prog^name 

Figure 101.13. Text of config vdts rgen Report 

Where “sysdata.config” appears in these reports, substitute the name of 
your configuration file (if it is different). Where “x” appears, substitute the 
system id of the system for which the report is being run (for example, “e” 
for editorial; “c” for advertising). 

Step 8: Correcting Excessive Page Faults 

Once all of the necessary data has been gathered, we must analyze it to 
determine if there are any problems. The first thing we need to look at is 
the page faults or swap rate. Excessive page faults can be the most 
damaging to your system performance so this is the area that is always 
corrected first. 

Excessive page faults can mean; 

1 . The swap rate for any one cpu is greater than .5 

2. The difference in the swap rate between any two cpus is greater than .2 

For example, suppose the swap rate for all cpus is less than .5, but one 
cpu has a swap rate of .01 while another has a swap rate of .3. In this case 
the swap rate is considered excessive and steps should be taken to 
balance out the swap rates. 

If the swap rates are excessive, balancing them is a matter of moving 
processes. We do this by XRAYing the application and supporting process¬ 
es to determine which ones are placing the highest demands on their 
CPU’s memory. 

What to Measure 

Using a new xraycom configuration file, measure the application and 
supporting system processes. 

PROGRAMS: Ssystem.*.* 

$vol.*.* 

This should only be done while trying to correct excessive page faults. 
To collect basic xray data, you should use the configuration file outlined in 
Step 3. XRAYing a large number of programs places significant overhead 
on the system. 

What to Look For 

Using the xrayscan command, find which processes are placing the 
highest demands on the cpu’s memory (as indicated by a high pres 
pages value. 

PROCESS (cpu n) BY PRES PAGES 
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Corrective Steps 


Try to eliminate heavy page swapping by moving a process with a high 
pres pages value from the swapping cpu into a cpu that is not swapping. 
Do not be discouraged if the first process you move does not solve the 
problem. 


Eliminating page swapping is usually a cyclical operation. If moving a 
particular process just moves the swap activity to a different cpu, move the 
process back, and try another, smaller process. What you are trying to 
accomplish is to balance the swap activity over all cpus. 


If balancing the swap activity does not solve the swapping problem, your 
system probably needs additional memory. 


Step 9: Correcting Excessive Disk I/O 

To determine if the disk i/o is excessive, find the process reports gener¬ 
ated in Step 3, locate the disk processes, and check their recv rate and 
recv qlen. recv rate values higher than 12 or 13 are excessive and a 
recv qlen greater than 1.5 is also excessive. If is possible for these 
values to be acceptable but two disk processes could differ by some 
significant amount. If the recv qlen for any two disk processes differ by 
more than .5, this is also considered to be excessive and balancing steps 
should be taken. 


There are several causes for excessive disk i/o. One possibility is too 
many enscribe file index levels. For the most part, no enscribe file on the 
System/55 should have an index level greater than 2. If some are found, 
then the files should be redefined and reloaded. The files that can go to 
three index levels are usually the header file alternate key files. The 
Tandem utility fup will provide you with this information by using the 
following command: 

INFO (file name), detail 


If index levels are found to be excessive, the file should be redefined 
with a larger index block size, index compression should be turned on, and 
the file reloaded. If you are not sure how to accomplish this, contact your 
Site manager. 

Another area that frequently causes excessive disk i/o is the failure to 
install directory extracts. Directory extracts are most helpful on the editorial 
system. If you are not sure whether directory extracts are installed at your 
site, you can find out by looking at the vdt Statistics collected in Step 5. If 
directory extracts are turned on, all the directory commands listed in the 
VDT statistics report (d, l, .d, r, ,l, and so on)will have a + in front of the 
command. If the directory extracts are not turned on, it is very important 
you take care of this as soon as possible. Your directory performance will 
improve and the overall disk i/o will decrease. If you are not sure how to 
turn on directory extracts, contact your Site Manager. 


Now that we have checked the index levels and the directory extracts 
and the disk i/o is still excessive, we need to take corrective action. 
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What to Measure 

Having the busiest disk using the data collected in Step 3, you can now 
modify the xraycom configuration file as follows to measure all application 
data files on the busy drive. 

FILES: $(busy vol.*.* 

This should only be done while trying to correct excessive disk i/o. To 
collect basic xray data, you should use the configuration file outlined in 
Step 3. XRAYing a large number of files places significant overhead on the 
system. 

What to Look For 

Use the xrayscan command to find the busiest files on the busy drive. 
These will be the files with the highest drive rate. 

DISCOPEN, BY DRIVE RATE 

Corrective Steps 

Move busy files, one at a time, to balance the recv qlen and recv rate 
across all of the disk processes in the system. Start with the easiest-to- 
move files first. Alternate key files are easy to move and the header 
alternate key files generally contribute significant disk I/O. 

If, after disk i/o is balanced across all the disk processes, the disk i/o is 
still excessive, the only alternative is to add additional disk volumes. 

Step 10: Correcting Excessive CPU Busy 

To determine if the cpu busy is excessive, find the cpu report collected 
in S v tep 3 and check the cpu busy and cpu qlen for all the cpus. 

As a general rule, no cpu should be over 50 percent busy. Usually, this 
keeps cpu qlen down. As a general rule, the cpu qlen should be less 
than 2. 

The System/55 workload should be shared equally by all the proces¬ 
sors. Therefore, even if each cpu busy is less than 50 percent, we could 
still have a problem if any two cpu’s cpu busy differ by more than 10 
percent. 

Once we have determined that cpu busy is excessive we need to take 
corrective action. 

What to Measure 

Using the xraycom configuration file, measure all of the system and 
application processes. If you have processes located in subvolumes other 
than those listed in the example below, measure them as well. 

PROGRAMS: SYSPROCS 

Ssystem.sii.* 

Ssystem.system.* 

This should only be done while trying to correct excessive cpu busy. To 
collect basic xray data, you should use the configuration file outlined in 
Step 3. XRAYing a large number of programs places significant overhead 
on the system. 
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What to Look For 

Using the xrayscan command, find the busiest processes in each cpu. 

PROCESS icpu n), BY CPU BUSY 

Corrective Steps 

Move busy processes, one at a time, to achieve cpu balance. Keep in 
mind that moving processes in this step may affect your swap rate 
balancing performed in Step 8. Therefore, you should move processes 
around so that the cpu busy is altered but the memory usage wili be the 
same. 

If, after cpu busy for all cpus is balanced, cpu busy is still excessive, 
the only alternative is to add additional cpus. 

Step 11: Correcting Excessive Queueing Delays 

Once the system is balanced as far as swap rate, disk i/o, and cpu 
busy are concerned, we next need to look to see if there are queueing 
delays on the god servers. Large queueing delays will generally mean that 
there are not enough processes running to handle the transaction rate. 
The System/55 has the capability of running multiple processes (more 
than one just, save, headfit, spellcheck, and so on) to handle large 
numbers of transactions. If one process cannot handle the transaction 
load, additional processes must be run to handle the load. 

To determine if enough god server processes are running, we use the 
god busy statistics collected in Step 4. The number following the + is the 
averaging queueing delay for that process. Generally, a delay greater than 
.5 is an indication that additional processes may be required. However, an 
imbalanced system can also cause queueing delays so it is important to 
balance the system first before trying to add processes. 

If you have to add processes, the swap rates and cpu busy will be 
affected so you will need to go back and collect new xray data to make 
sure the system is still balanced. 

Step 12: Eliminating Unnecessary Processes 

To determine if there are unnecessary processes, we again use the god 
busy statistics collected in Step 4. This time we need to look at the number 
of requests processed by each process. If some processes never service 
requests, they are certainly good candidates for removal. If a process 
handles less than 5 percent of the total transactions for that server class, it 
is a good candidate for removal. However, you must be careful not to 
make any hasty decisions. Data collected on one day is probably not 
enough information to make a decision. You should look at the date over 
the period of a week, then, if processes consistently show low usage, 
remove them. 
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Figure 101.14. System Tuning and Balancing Operations. 


101.14 










































System Management Topics 


Avoiding Contamination of Disk Packs 


SECTION 102 

Avoiding Contamination 
of Disk Packs 


Contamination is one of the biggest problems with packs used in your 
system. In order to avoid possible damage to disk drives, Sll recommends 
that all packs be acclimatized and inspected prior to use. Any disk pack 
that is removed from the normal computer room environment for any 
period of time should be acclimatized before it is used. Because changes 
in temperature cause changes in the oxide surface of the platters, a pack 
that has not been acclimatized can cause a head crash. 


Disk Pack Storage and Handling Considerations 


The procedures outlined below, designed to ensure maximum disk pack 

life and reliability, apply to all types of drives and disk packs. 

* 

• When you receive a pack, inspect the container for damage. If there is 
obvious damage to the container, there may be damage to the pack as 
well. If the pack has been damaged, notify the carrier and Sll immediate¬ 
ly- 





Inspect the pack for cracks or breaks in the case. Foreign particles 
between the platters will scratch the surfaces and cause a head crash 
when the pack is used. 


• Store disk packs in computer room atmosphere, 60 to 80 degrees 
Fahrenheit, 10 to 80 percent relative humidity; if the disk pack must be 
stored in a different environment, allow four hours for adjustment to 
computer room environment before use. 


• Never store a disk pack in direct sunlight or in a dirty environment. 

• Store disk packs flat, not on edge. They may be stacked with similar 
packs when stored. 

• Be certain that the top and bottom plastic covers are on the pack and 
locked together whenever the pack is not actually installed on the drive. 

• When marking packs, use a pen or felt tip marker that does not produce 
loose residue. Never use a pencil. 


• Do not attach any label to the disk pack itself. Labels will not remain 
attached when the pack is spinning (3600 rpm) and will cause cata¬ 
strophic head crashes. Any required labels should be placed on the 
pack canister. 

• Cleaning of disk pack surfaces is not recommended, except by a quali¬ 
fied disk pack cleaning technician. 





Make certain that no dust or other foreign particles are present in the 
shroud areas. Also, ensure that the blowers operate for at least two 
minutes prior to disk pack installation in order tp purge the blower 
system. After installing the pack, wait for one minute with cover down to 
purge the pack of loose particles. 
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• Check the prefilter and absolute filters for positive pressure of at least 
0.5 inch/pounds. Filters should be cleaned and replaced according to 
manufacturer’s specifications (cdc recommends cleaning the primary 
filter very 1,500 operating hours, and replacing the absolute filter every 
9,000 operating hours. These are maximum values, and depend on the 
cleanliness of the operating environment.) 

• The computer room environment itself should be kept clean. Keep food 
and drinks out of the area. Change air conditioning filters regularly. 
Smoking should not be allowed. 

• If you receive a pack from SI I and it does become damaged for any 
reason, notify Sll immediately. Do not put the pack on a drive. 

Recommended Procedure 

The recommended procedure for installing disk packs on the drive is 
outlined below. 

1. Make certain the disk pack has been in the computer environment, 
uncrated, for a minimum of four hours. 

. 2. Make certain that the disk drive air filtration system has been on for a 
minimum of two minutes. 

3. Make certain that the disk pack has been installed on the drive with the 
cover closed for at least one minute. 

4. When you mount the pack on the drive, listen for abnormal noises as 
the heads load onto the pack (approximately 10 to 20 seconds after the 
drive is started). If abnormal sounds occur, shut down the drive and 
notify your System Manager. 

5. Continue to monitor the system and drive to ensure proper operation. A 
head crash can occur long after the heads have loaded onto the pack. 

6. If there are problems with a pack do not move it to another drive. A 
damaged pack will crash another drive. 

Indications of a Head Crash 

The heads actually ride on a very thin (30 micro inches) air cushion. 
Figure 102.1 shows the relationship between head/disk flying distance and 
contamination particles. A head crash occurs when the heads contact the 
disk surface and/or any contamination particles on the head or disk pack 
surface. 

A head crash may be indicated by any of the following conditions: 

• A sudden increase in retries related to one or more heads. 

• An unusual noise such as pinging or scratching. 

• A burning odor. 

® Suspected contamination of the pack from dust, smoke, oil, or other 
foreign material. 
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Figure 102.1. Common Disk Contaminants 
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CAUTION 

If you suspect a head crash, do not operate the 
disk pack on another drive until you are certain that 
no damage has occurred to the disk pack. Do not 
operate the drive with another disk pack until you 
are certain that no damage has occurred to the 
drive. 

If there are any indications of a head crash, power 
down the drive (leaving the disk pack installed) and 
label it unusable until qualified personnel have de¬ 
termined that it is safe to operate the drive and disk 
pack 


Cleaning disk packs and/or heads should be done only by qualified and 
trained personnel. Please contact Sll Field Engineering if you need assis¬ 
tance. 


Although it is not possible to predict a head crash, following these 
procedures will minimize the chances of having one caused by a new 
pack. 
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SECTION 103 

Troubleshooting Coyote Terminals 

This section of the System Manager’s Manual is intended to be a guide 
for solving software and hardware problems for System Integrators’ Coy¬ 
ote Display Terminals. A Coyote terminal can be inoperable for a number 
of reasons. For example, there might be a problem with the software 
configuration that operates the display on the Coyote terminal, or a hard¬ 
ware malfunction in the terminal itself. Using this section, the reader can 
isolate the problem, and then follow a step-by-step procedure that will get 
the terminal functioning again. 

The reader is assumed to have a basic knowledge of the main compo¬ 
nents of the Coyote terminal, and an understanding of the software of 
System Integrators’ Computer-Aided Publishing System. 

This section offers solutions to basic problems that you may encounter 
with Coyote terminals. It does not offer solutions to all problems—more 
difficult problems must be handled by specialized personnel. 

How to Use this Section 

The reader must first identify the symptom of the problem and locate it’s 
identifying headline. Under each heading there is a list of possible causes 
for the particular symptom. This list is ordered from the most probable to 
the least probable cause. Associated with each possible cause is a refer¬ 
ence to a numbered subsection that describes how to solve the given 
problem. 

To solve the problem, you can try to correct any of the listed causes. 
However, if you have no idea of what the cause may be, it is best to start 
with the most probable (the first cause listed) and work your way down the 
list until the problem is solved. 

Symptoms of Terminal Problems 

Carefully choose the symptom that best describes the terminal from the 
list below. Then, locate the heading on the following pages. 

1. No Response from the Keyboard 

2. No Display On Screen At All 

3. Terminal Will Not Download or Does Not Complete Downloading 

4. Only Status Line Displayed 

5. Unusual Characters or Lines Across Screen 

6. Unusual Responses While in Command Interpreter 

7. Keyboard Produces Incorrect Characters or Functions 

If all else falls: Turn the terminal off, wait at least five seconds, then turn 
it back on. Go back to the above list of symptoms and select the one that 
applies best. 
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No Response from the Keyboard 

If both sides of a terminal are not responding while the user is in the 
Editorial or Advertising subsystem (not in a utility), the possible causes 
are: 

1. Prompts on one or both sides of the terminal (see “14—Prompts on 
One or Both Sides of Terminal”). 

2. vcontrol process is not running (see “9 —vcontrol Process is not 
Running”). 

3. Bad terminal cable connection (see “5—Bad Terminal Cable Connec¬ 
tion”). 

4. Invalid config entry (see “18—Invalid Config Entry”). 

5. Device has been disabled (see “6—Device has been Disabled”). 

6. Process is in debug or inspect (see “15—Process is in debug or 
inspect”). 

7. Bad keyboard (see “4—Bad Keyboard”). 

8. Bad keyboard cord (see “3—Bad Keyboard Cord”). 

If only one side of the terminal is not responding, the possible causes 
are: 

1. One side of terminal is not open (“16—One Side of Terminal is not 
Open”). 

2. Invalid Config Entry (see “18—Invalid Config Entry”). 

If the message “vdt stopped for system maintenance” is displayed 
on the status line, the probable cause is: 

1. vcontrol process stopped with vup utility (“17— vcontrol Process 
has been Stopped with vup Utility”). 

If the message “pc trap xxxx” is displayed on the status line, download 
the terminal. 

No Display on Screen at All 

If there is no display on either side of the terminal, the possible causes 
are: 

1. Brightness and/or contrast turned down (see “2—Brightness and/or 
Contrast Turned Down”). 

2. Loss of electrical power (see “1—Loss of Electrical Power”). 

If the keyboard led light (left hand side) is on, but there is no display, 
download the terminal. 

If there is no display on only one side of the terminal, possible causes 
are: 

1. One side of terminal is not open (see “16—One Side of Terminal is not 
Open”). 

2. Process (remote vcontrol) is in debug or inspect (see “15 —Process 
is in debug or inspect”). 
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Terminal Will Not Download 
or Does Not Complete Downloading 


If the terminal does not start to download, the possible causes are: 


1. Wrong terminal switch settings (see “7—Wrong Terminal Switch Set¬ 
tings”). 

2. Download process is not running (see ‘‘10—Download Process is not 
Running”). 

3. Malfunctioning circuit boards (see “8—Malfunctioning Circuit Boards”). 

4. Bad terminal cable connection (see “5—Bad Terminal Cable Connec¬ 
tion"). 

5. Device has been disabled (see “6—Device has been Disabled”). 


If the terminal consistently stops after partially downloading, a possible 
cause is: 


1 . Incomplete vdt control list (see “11 —Incomplete vdt Control List”). 


Only Status Line Displayed 

If only “l” or “r”, date and time are displayed, but no sign-on prompt is 
shown, the possible causes are: 


1. vcontrol process is not running (see ‘9— vcontrol Process is not 
Running”). 


2. Incorrect files downloaded into terminal memory (see “12—Incorrect 
Files Downloaded into Terminal Memory"). 



3. 


Multiple processes running against terminal (see “13—Multiple Pro¬ 
cesses Running Against Terminal”). 


4. Device has been disabled (see “6—Device has been Disabled”). 

5. Process is in debug or inspect (see “15—Process is in debug or 
inspect”). 


6. Bad keyboard (see “4—Bad Keyboard”). 

7. Bad keyboard cord (see “3—Bad Keyboard Cord”). 


If the message “vdt stopped for system maintenance” is displayed 
on the status line, the probable possible cause is: 


1. vcontrol process stopped with vup utility (see “17 — vcontrol Pro¬ 
cess has been Stopped with vup Utility”). 


Unusual Characters or Lines Across Screen 

If there are horizontal and/or vertical lines across the screen, a possible 
cause is: 

1. Malfunctioning circuit boards (see “8—Malfunctioning Circuit Boards”). 


Unusual Responses While in Command Interpreter 

If you encounter the message “Can’t return to text editing,” while trying 
to exit command interpreter, a possible cause is: 



1. 


Multiple processes running against terminal (see “13—Multiple Pro¬ 
cesses Running Against Terminal”). 


2. vcontrol process is not running (see “9— vcontrol Process is not 
Running”). 
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If you encounter uncharacteristic prompts (or responses) while running 
a utility, a possible cause is: 

1. Multiple processes running against terminal (see “13—Multiple Pro¬ 
cesses Running Against Terminal”). 

Keyboard Produces Incorrect Characters or Functions 

If the keyboard is producing unexpected characters or functions when a 
key is depressed, the possible causes are: 

1. Incorrect files downloaded into terminal memory (see “12—Incorrect 
Files Downloaded into Terminal Memory”). 

2. Bad keyboard (see “4—Bad Keyboard”). 

Causes with Solutions 

Locate the possible cause of the terminal’s problem below. 

1— Loss of Electrical Power 

If the keyboard led light (left hand side) is not on, and the keyboard 
cable is securely attached, then your terminal is not receiving any electrical 
power. 

1. Check the “on/off” black power switch at the base of the terminal—it 
should be pressed downward toward the center of the base. 

2. Check the electrical plug to see that it is adequately plugged into the 
back of the terminal and to the wall outlet. 

3. Check the fuse in the back base of the terminal (next to the ac plug)—it 
may be missing, loose, or burned out. 

2— Brightness and/or Contrast Turned Down 

On the lower right hand corner of the face of the terminal are two 
adjustment knobs labeled “brightness" and “contrast”. Turn both of 
these knobs all the way to the right to see if this is the problem. 

3— Bad Keyboard Cord 

Try replacing the keyboard cord with one that works properly. 

4— Bad Keyboard 

Try replacing the keyboard with one that works properly. 

5— Bad Terminal Cable Connection 

Check to see that the terminal cable is securely attached to the back of 
the terminal. The cabie should be plugged into the port labeled "host”. 
Also, check to see tha: the terminal cable is securely plugged into the wall 

port (if applicable) and/or to the host computer itself. 
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6—Device has been Disabled 


To determine if a device is disabled, execute pup as illustrated in Figure 
103.1, below. 


; pup 

listdev 

type 7,51 





LDEV 

NAME 

STATE PPID 

PCU 

BPID BCU 

DMNT TYPE 

SUBTYPE 

28 

$F1 

00,019 

%240 

01,019 %240 

7 

51 

29 

$F2 

01,020 

%260 

00,020 %260 

7 

51 

30 

$F3 

01,021 

%300 

00,021 %300 

7 

51 

31 

$F 4 

D 01,022 

%320 

00,022 %320 

7 

51 

32 

$F5 

01,023 

%340 

00,023 %340 

7 

51 

33 

$F6 

00,024 

%360 

01,024 %360 

7 

51 


Figure 103.1. pup listdev for Coyote Terminals 


In Figure 103.1, a “d” in the state column indicates that $F4 is disabled. 
To enable $F4, execute the following PUP command: 

;pup up $F4 

If the command was executed successfully, a second pup listdev 
should not show a “d” in the state column. 

7—Wrong Terminal Switch Settings 

Many times a terminal will not download because it has an incorrect 
switch setting. The easiest way to determine the switch setting of a termi¬ 
nal is to turn it off, wait 10 seconds, and then turn it back on. The status 
line should display something like: 

FTML0AD2 000 

The number following the word “ftmload" (in this case, 2) is the switch 
setting of the terminal. 

If this switch setting is incorrect, follow the steps below. 

1. Turn the terminal off. 

2. Take off the screws on the back panel of the terminal. 

3. On the top of the circuit board nearest to you is a red box with dip 
switches. The dip switches marked 6, 7, and 8 determine a terminal’s 
switch setting. If a switch is facing away from you, it is on. Use the 
following table to set a terminal’s switch setting. 

If the system has ftms, dip switch #5 should be on; switches #1 - #4 
should be off. 

~ Table 103.1 

Coyote Terminal Switch Settings 


SWITCH # 

6 7 8 

SWITCH SETTING 

OFF 

OFF 

OFF 

0 

OFF 

OFF 

ON 

1 

OFF 

ON 

OFF 

2 

OFF 

ON 

ON 

3 

ON 

OFF 

OFF 

4 

ON 

OFF 

ON 

5 

ON 

ON 

OFF 

6 

ON 

ON 

ON 

7 
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8— Malfunctioning Circuit Boards 

Most Coyote terminals have three circuit boards. (The only exception is 
the Coyote IV which has only one board.) One of these boards is the cpu 
board, and the two others are the video boards. A terminal can have 
problems when one (or more) of the circuit boards malfunction. 

On possible solution to this problehn is to reseat the boards. To do so, 
follow the steps below. 

1. Turn the terminal off. 

2. Take off the screws on the back panel of the terminal. 

3. The back panel should fall out, but if it does not, then carefully pull the 
back off yourself. (It is usually easier to take the bottom out first.) 

4. Use the white tabs on the top corners to loosen each board. (Do not 
remove it all the way out of the slots.) 

5. Firmly press down on each board to reseat them in their slots. If the 
boards have been seated properly, you should hear a snapping sound 
as the board goes into the slot. 

6. Replace the back panel of the terminal. 

7. Turn the terminal back on. 

8. If the problem is not resolved, one of the circuit boards may need to be 
replaced. 

9— VCONTROL Process is not Running 

To determine if the vcontrol process is running, execute the following 
ppd command: 

; ppd ${name) 

name is the name of the vcontrol process (for example, $F304). 

1. If the response to this command is “No such process,” the vcontrol 
process is not running. To start the process again, execute the re¬ 
quest utility as illustrated in Figure 103.2. 


;request Sconf 

01,121 

? il 

01,121 

? EOF! 

01,121 

Process? Szeus 

01,121 

? il 

01,121 

9 EOF! 

01,121 

Process? EOF! 


Figure 103.2. request Function to Restart vcontrol Process 


2. Next, execute the ppd command again: 

; ppd $<name) 

3. If the response to the ppd command is still “No such process,” get a list 
(cmd x) of the configuration file (list name config, path pn. Edit the 
form for the vcontrol process name (for example, $F 304 ). Compare 
the parameters with a vcontrol process that is known to work in the 
same subsystem. 

4. If the process still fails to start, you may not have the proper authority. 
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10—Download Process Is not Running 

To determine if the download processes are running, execute the follow¬ 
ing ppd command: 

;ppd $dnf* 


If there should be six download processes, the response to the above 
command would appear as illustrated in Figure 103.3. 


Name 

PID1 

PID2 Parent 

Program 

file name 


SDNFl 

01,035 

00,036 

01,029 SDATA 

. SII 

.DOWNLD 

$DNF2 

00,035 

01,036 

01,029 SDATA 

. SII 

.DOWNLD 

SDNF3 

01,037 

00,037 

01,029 SDATA 

. SII 

.DOWNLD 

$DNF4 

00,038 

01,038 

01,029 SDATA 

. SII 

.DOWNLD 

$DNF5 

01,039 

00,039 

01,029 SDATA 

. SII 

.DOWNLD 

SDNF6 

01,029 

00,040 

01,029 SDATA 

. SII 

.DOWNLD 

6 Items listed 






Figure 103.3. PPD Listing for Download Processes 


If all the download processes are not running, execute the obey fiie 
(preferably from the osp) to start them: 

From the osp: 


:o obey.download 


From SH’s Command Interpreter: 


;eomint/in obey.download/ 

Next, execute the PPD command again to see if all the download process¬ 
es are running. 


;ppd $dnf 


* 


11—Incomplete VDT Control List 


The vdt control list determines which files are to be downloaded into 
a terminal’s memory. If an entry for a necessary file is missing, terminals 
will only partially download. 

1. Determine the switch setting of the terminal (see “7—Wrong Terminal 
Switch Settings".) 


2. Get the vdt control list. A typical vdt control list is illustrated in 


Figure 103.4. 


VDT Download Control 
Process TCU Type 

File 

# 

Device 

File name 

$DNC 

X 

B 

0 

* 

SSYSTEM.M68.CT4 

SDNC 

X 

B 

1 

* 

SSYSTEM.M68.CT4 

SDNC 

X 

B 

2 

* 

SSYSTEM.M68. CT4 

SDNC 

X 

B 

3 

* 

SSYSTEM.M68. CT4 

SDNC 

X 

B 

4 

* 

SSYSTEM.M68.CT4 


Figure 103.4. Sample vdt control List 


3. 



For each switch setting number (in the “#" column) there should be a 
corresponding entry in the “Type” column. The possible entries are 
listed below. Note that Coyote IV terminals need a “b” entry; soft key 
users need an additional “S” entry. 

C. E. F. K. M. Y. and Z 
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As a example, terminal of $F2 downloading to switch setting 2 should 
have the vdt control list entries illustrated in Figure 103.5. 


Process 

TCU 

Type 

# 

Device 

File name 

SDNF2 

X 

c 

2 

* 

$DATA.M68. FCTQB 

SDNF2 

X 

E 

2 

* 

$SYSTEM.COYOTE.ERRCOY 

$DNF2 

X 

F 

2 

* 

$SYSTEM.COYOTE.FUNCTION 

$DNF2 

X 

K 

2 

* 

$SYSTEM.COYOTE.SOFTDEF 

$DNF2 

X 

M 

2 

* 

$SYSTEM.COYOTE. SOFTMAT 

$DNF2 

X 

Y 

2 

* 

$SYSTEM.COYOTE.STATIND 

$DNF2 

X 

Z 

2 

* 

$SYSTEM.COYOTE. STATMSG 


Figure 103.5. vdt control List Entries for Terminal $F2 Downloading to Switch Setting 2 


12— Incorrect Files Downloaded into Terminal Memory 

A terminal performs strangely when incorrect files are downloaded into 
its memory. For example, problems arise when a user tries to use an 
advertising keyboard on a terminal that has been downloaded for editorial 
use. To correct the problem, download the terminal to the correct switch 
setting, (see “7—Wrong Terminal Switch Settings'’). 

13— Multiple Processes Running Against Terminal 

Suppose the right side of vcontrol process SF401 is having problems. 


1. Execute the status * for the right side of the terminal as illustrated in 
Figure 103.6. 


;s*,term SF4. #r01 



PID Pri Name 

Home Term 

Program file name 

00,137 140 

SF5. #L10 

SDATA .SII .Cl 

01,086 125 

SF5. #L10 

SSYSTEM .SYS04 . FUP 

01,101 125 

3 Items listed 

SF5. #L10 

$SYSTEM .SYS04 . PUP 


Figure 103.6. STATUS * Command for Right Side of vcontrol Process $F40i 


2. Stop all the processes that are listed (by the process id number) 
starting from the bottom and working up (see Figure 103.7). > 


;Stop 1,101 
;stop 1,086 
;stop 0.137 

Figure 103.7. Stopping Processes 

3.Execute the status * command again. 

;s*,term $F4. #r01 

If some of the processes are still listed, then you do not have the proper 
authority (command interpreter) to stop them. In this case, execute pstat 
for the process id numbers of the remaining processes to determine what 
command interpreter user can stop the processes (see Section 66, “Who 
Can Stop a Process”). If the semicolon prompt is displayed, the processes 
have been stopped successfully. 

4. If the terminal has not returned to the editorial/advertising subsystem, 
stop the vcontrol process one time. 
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14—Prompts on One or Both Sides of Terminal 



a 


If the prompt(s) cannot be terminated by pressing cancel, try sending a 
-20” request to the process. Such a request (for process $F402) is illus¬ 


trated in Figure 103.8. 


;request 
01,123; 
01,123; 
01,123; 


SF402 
? -20 
? EOF! 
Process 9 


EOF! 


Figure 103.8. -20 Request to Process SF402 


If the prompt or prompts still have the terminal locked up, try stopping 
the process one time. 

;stop $f402 


15—Process is in DEBUG or INSPECT 

To determine if a terminal process is in debug, execute the following 
pstat command. 

;pstat $(process name) % 

If the pstat contains a line similar to the example below, the process is in 

DEBUG. 


****** PROCESS IS IN DEBUG ********* 


To determine if a terminal process is in inspect, execute status * as 
illustrated in Figure 103.9. 


;s *,jprog Ssystem.system.inspect 

PID Pri Name Home Term Program file name 

00,138 197 SF5. #L11 SSYSTEM .SYSTEM .INSPECT 


Figure 103.9. status ' Listing for inspect 


If the resulting listing shows the malfunctioning terminal as the home 
term of the inspect process, the terminal process is in inspect. 

If a terminal process is in inspect or debug, go to the osp to stop the 
process. To do so, type pause at the colon prompt. 

The inspect or debug prompt will be displayed. Type stop at the 
prompt to stop the inspect or debug process. 


16—One Side of Terminal Is not Open 

If the right side of the terminal is blank, execute command comma q 
from the left side of the terminal. 

If the above procedure doesn’t work, get a list (cmd x) of the configura¬ 
tion file (list name config, path pn). Edit the form for the vcontrol 
process name (for example, $F 304 ). Compare the parameters with a 
vcontrol process that is known to work in the same subsystem. 
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If you make any changes, execute the commands illustrated in Figure 
103.10. (Process name $F304 is used as an example.) ~\ 


;stop $f304 
;stop $f304 
no such process 
;request $conf 
01,121; ?il 
01,121; ?E0F! 

01,121; Process? $zeus 
01,121; ?il 
01,121; ?EOF! 

01,121; Process? EOF! 


Figure 103.10. Stopping and Restarting Process SF304 Following Changes to Configuration File Record 


17—VCONTROL Process has been Stopped with VUP 
Utility 

To enable a terminal that has been stopped with the vup utility (see 
Section 94), execute the VUP command illustrated below. (Process name 
$F304 is used as an example.) 

;vup start proc $f304 


18—Invalid Config Entry 


Get a list (cmd x) of the configuration file (list name config, path pn). 
Edit the form for the vcontrol process name (for example, SF304). Com¬ 
pare the parameters with a vcontrol process that is known to work in the 
same subsystem. 


If you make any changes, execute the commands illustrated in Figure 
103.10. (Process name $F304 is used as an example.) 


;stop $f304 
;stop $f304 
no such process 
;request Sconf 
01,121; ?il 
01,121; ? EOF! 

01,121; Process? Szeus 
01,121; ?il 
01,121; ? EOF! 

01,121; Process? EOF! 

Figure 103.10. Stopping and Restarting Process $F304 Following Changes to Configuration File Record 

(repeated) 
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SECTION 104 

Daily Activities 

Hardware Check 

Check the run and power lights of all the processors—they should be 
on. If the power light is off, you have lost ac and it must be restored before 
the processor can be reloaded. Consult your hardware technician. 

If the run light is off, you have had a cpu failure. 

Check the fault lights of all the disk drives—they should be off. If a fault 
light is on, consult your hardware technician. Check all other peripherals 
(printer, typesetter, etc.) for “up” status. 

AO PR Log Check 

The aopr Log should be checked for any error messages that may need 
action. Examine the messages that were logged while you were away from 
work to update yourself on system problems. Check the $aopr process 
itself to ensure that it is sending messages. 

System Status Check 

A thorough system status check would include at least the following: 

• pup listdev — to check the device status and primary cpu. 

• peek/CPU (number)/ — to check the performance of the cpus. 

• pup listfree (volume), hist or dsap (volume), freespace — to check 
disk space. 

• percent — to check text file space. 

• fup info (header file), stat — to check the number of free header 
records. 

• netmon probe — to check what systems are available on the network. 

• pup listdev type 63 — check the network lines. 

• spoolcom (commands)— to check the status of spoolers and their 
processes. 

• b stats — to check the performance of server processes. 

• dstat (commands)— to check vdt response times. 

Security Check 

The list of users should be checked for user profiles that have improper 
authority. Filters can be used on this list to check authority levels (access, 
assign, etc), command authorities (user modify, user create, etc.) and 
Tandem user levels. Be sure to check security for all logical systems 
(editorial and advertising) if necessary. 

The Tandem security levels of programs such as fup, pup, vup, re¬ 
quest, q, and so on should be checked daily. Also, rgens can be execut 
ed to check for copies of particular programs that have been secretly 
duplicated. 
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Magnetic Tape Backups 

Tape backups should be performed on a regular basis using both the 
Tandem Backup program and Sll's tape utility. The tape library should be 
maintained in an organized manner. 


\ 







104.2 



System Management Topics 


Procedures During a CPU Halt 


SECTION 105 

Procedures During a CPU Halt 


This section describes the steps that should be followed when a tns ii or 
txp processor fails. 

1. First, write down the following information for the affected processor: 

a. whether or not the front panel power light is on 

b. whether or not the front panel run light is on 

c. the value displayed in the front panel lights (write down the bit 
numbers if necessary) 

d. the message on the status line (25th line) of the osp 

2. Press IshiftI and [fs] on the osp keyboard to get the System Proces¬ 
sors Status display (Figure 105.1). 


OSP 

- 9938B00 

- (28JAN85) 








SYSTEM PROCESSORS STATUS 




p# 

STATUS T 

POLL 

P# STATUS T POLL 

P# STATUS T POLL 

P# STATUS T 

POLL 


00 

..R.. 2 

1 

01 ,.R.. 2 1 

02 ..R.. 2 1 

03 ..R.. 1 

1 


04 


0 

05 . 0 

06 . 0 

07 . 

0 


08 


0 

08 . 0 

09 . 0 

10 . 

0 


12 


0 

13 . 0 

14 . 0 

15 . 

0 


H = 

= halted 

D = 

DDT system halt request 

R = reset enabled 

E = parity 

error 





P = processor system halt request 





Type: 


1 = NonStop II 

2 = NonStop TXP 





Figure 105.1. System Processors Status Display 


The poll field of the status display indicates whether the processor is in 
the poll list (the list of processors “watched” by the osp). In Figure 105.1, 
processors oo to 03 are in the poll list; processors 04 to 15 are not. 

The “t” ( type) field indicates whether the processor is a tns ii or txp 
processor. In Figure 105.1, processors oo to 02 are txps, and processor 
03 is a tns it. 


The status field displays the five status bits for each processor. Each 
field may contain a period (condition is not true) or letter (condition is true). 
In Figure 105.1, the reset enabled condition (r) is true for each processor 
in the poll list. Make a note of any unusual status bits (bits other than “R”). 
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3. Press Ishifti and [Fes] on the osp keyboard to get the Processor Status 
display (Figure 105.2 and 105.3). 


Nonstop TXP PROCESSOR 02 STATUS FROM DDT 

Switch setting for Cold Load or Dump: 100000 


Current Processor Status: 
Executing 


Figure 105.2. TXP Status Display 


NonStop II PROCESSOR 03 STATUS FROM DDT 

Switch setting for Cold Load or Dump: 100000 


Current Processor Status: 

Executing 

RMD Address: 21376 RME Address: 21547 


Current Channel Status: 

Idle loop waiting for processor request or I/O reconnect CCSD ADDR = 0103 


Figure 105.3. TNS II Status Dispiay 


If the status information displayed is not for the failed processor, switch 
to the desired processor by entering the desired cpu number in the field on 
the top of the form, and pressing [FT] on the osp keyboard. 

Check the Current Processor Status field. Write down exactly what it 
says. If the status is “Executing,” the processor is running (though it may 
also be looping and thus malfunctioning). The osp User Guide gives a 
detailed list of the possible processor state messages. These messages 
fall into two general classes: software related and hardware related. 

The most important software message is “System freeze instruction 
executed.” This indicates that the processor failed an internal consistency 
check. A memory dump should always be taken when this message is 
logged. Without a memory dump, Sll will be unable to determine why the 
consistency check failed. The only other time that a memory dump is 
indicated is if the processor has been declared down the by rest of the 
system, but the status is “Executing” (indicating a looping processor). 

Virtually all other messages indicate a hardware problem. Sometimes a 
halt number is displayed in the front panel lights (for example, if the 
message is “Halt instruction executed”). At other times the front panel 
lights contain no significant information (for example if the message is 
“Parity error has frozen processor”). Parity errors are the most frequent 
hardware problem. The osp User Guide gives detailed information about 
the various parity errors and the most likely cause of the error. 

If you are unsure whether you have a hardware or software problem, 
don’t do anything. Instead, leave the processor down and contact Sll for 
further instructions. If this is unacceptable, get a memory dump and at¬ 
tempt to reload the processor. 

Remember: write down anything unusual. 
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~ SECTION 106 

Locating Error Message 
Documentation 

Several types of error messages are generated by the System/55. 
Some originate from the guardian™ Operating System and Tandem utili¬ 
ties, the remainder from Sll application processes and utilities. This sec¬ 
tion identifies each error message type and specifies where 
documentation may be found (Table 106.1). 

Errors are reported to the System Operator on one or more console 
logging devices. On the tns i-based System/55, a hardcopy device 
Stermi is the standard error-logging device. On the tns ii- and TXP-based 
System/55, the $osp is the standard error-logging device. There are op¬ 
tional requests to enable logging on other devices. The Saopr process 
performs this function (see Section 8). 


Table 106.1 

Error Message Documentation 

TYPE OF ERROR MESSAGE 

WHERE DOCUMENTED 

Sll Application 

At the end of each process section in ap¬ 
propriate manual 

Sll Utilities 

At the end of each utility section in ap¬ 
propriate manual 

Spooler Management 

Tandem Spooler Management Guide 

File Management 

From Command Interpreter run error util¬ 
ity Error -1 will display all file manage¬ 
ment errors (also, see Appendix B of this 
manual) 

NEWPROCESS 

guardian Operating System Command 

Language Utilities Manual 

Console Messages 

Execute cmd x, list name aopr groups, 
or see Tandem System Operations Man¬ 
ual 

Cold-load Messages 

Tandem System Operations Manual 
(Display in front panel lights only during 
processor loading) 

Processor Halts 

Tandem System Operations Manual 
(Display in front panel lights when run¬ 
ning processor fails) 

Tandem Utilities 

At the end of each section in appropriate 
manual 
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SECTION 107 

Controller Path Verification 

It is vitally important to check controller and processor paths regularly to 
ensure that all backup paths to any device are available in case of the 
primary path failure. If these paths are not checked, and exercised, the 
possibility of device unavailability exists. Sll recommends that these paths 
be changed, checked, and changed back daily. 

System/55 has at least two possible data paths to each i/o controller. In 
the case of the disk controllers, there are four available paths to the data 
on each volume (two physical disk drives). 

The Tandem operating system monitors the current path to a device to 
ensure that the path is operational. If the primary path becomes nonopera- 
tional, the operating system declares that path down, and switches to the 
backup path. If the backup path is also bad, then the devices attached to 
that controller are no longer available to the system. Figure 107.1 shows 
the available paths to a byte sync controller. 



Figure 107.1. Paths to the Byte Sync Controller 


In the case of the disk controllers, four paths are available to the data on 
each disk volume (two physical drives [see Figure 107.2]). The Tandem 
operating system writes data to both disks, and reads data from one disk. 
During a write, the controller sends data to both drives. It then expects a 
response from both drives indicating that the data arrived correctly. During 
a read, the controller requests the data from one disk drive. In either case, 
if there is no response from a path, the system declares that path down 
and tries the alternate path to that physical disk drive. 

If the alternate path has no response it is declared down and the system 
requests (or writes) the data via the other paths on the other physical disk 
drive in that volume. 


107.1 



















Controller Path Verification 


System Management Topics 



Figure 107.2. Paths to the Disk Drives 


Using Obey Files to Check Paths 

Obey files can be set up, and scheduled using Sll utility sched, to check 
each path and send a report of the condition of the path to a hard-copy 
console printer or to the system spooler for eventual output. The following 
sample obey files can be used to check and change paths to volume 
Ssystem. In all of the following obey files, output is sent to the spooler for 
later analysis and possible output to a printer. See Figure 107.2 for the 
available data paths to Ssystem. Comments are included in the obey files 
for clarity; they are not required. 


COMMENT ******************************************* 

COMMENT SSYSTEM.OBEY.PATHPM 

COMMENT to switch paths to SSYSTEM-P and SSYSTEM-M 
COMMENT ******************************************* 

COMMENT to output 'before' listdev to spooler 

PUP /OUT SS.#PATHPM.BEFORE/LISTDEV 

COMMENT to primary paths to -p and -m 

PUP PRIMARY SSYSTEM-P 

PUP PRIMARY SSYSTEM-M 

COMMENT to test that path 

PUP LISTFREE SSYSTEM. HIST 

COMMENT to check on path status and output 'after' listdev to spooler 
PUP /OUT SS. #PATHPM.AFTER /LISTDEV SSYSTEM 
COMMENT ******************************************* 

COMMENT end of obey file SSYSTEM.OBEY.PATHPM 

COMMENT ************************ ******************* _ 

Figure 107.3. Obey File Ssystem.obey.pathpm 
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After running Ssystem.obey.pathpm, the pup listdev should show the 
asterisks (current paths) next to Ssystem-p and $system-m. The obey file 
in Figure 107.4 will switch the paths back to $system-b and Ssystem-mb 
paths. 


COMMENT ******************************************* 

COMMENT SSYSTEM.OBEY.PATHBMB 

COMMENT to switch paths to SSYSTEM-B and SSYSTEM-MB 
COMMENT ******************************************* 

COMMENT to output 'before' listdev to spooler 

PUP /OUT $S. #PATHBMB. BEFORE/LISTDEV 

COMMENT to primary paths to -b and -mb 

PUP PRIMARY SSYSTEM-B 

PUP PRIMARY SSYSTEM-MB 

COMMENT to test that path 

PUP LISTFREE SSYSTEM, HIST 

COMMENT to check on path status and output 'after' listdev to spooler 
PUP /OUT SS. #PATHBMB. AFTER /LISTDEV SSYSTEM 
COMMENT ****^***************^***^*^*******^^****^** 

COMMENT end of obey file SSYSTEM.OBEY.PATHBMB 
COMMENT ******************************************* 

Figure 107.4. Obey File Ssystem.obey.pathbmb 


After running Ssystem.obey.pathbmb, the pup listdev should show 
the asterisk next to $system-b and Ssystem-mb. Note that these two 
obey files will only check the paths from the controller to the disk drives 
using the active (primary) processor path. The following obey file will 
ensure that the processor 0 path to both disk controllers is operational. 


COMMENT *^****************^*****^****>k*** J te**^***^ 3 te* 

COMMENT SSYSTEM.OBEY.PATHO 

COMMENT to check paths for processor 0 

COMMENT ******************************************* 

COMMENT to output 'before' listdev to spooler 

PUP /OUT SS. #PATH0. ONE/LISTDEV 

COMMENT to primary paths to -p and -m 

PUP PRIMARY SSYSTEM-P 

PUP PRIMARY SSYSTEM-M 

COMMENT to switch controller ownership to processor 0 
PUP PRIMARY SSYSTEM,0 
COMMENT to test that path 
PUP LISTFREE SSYSTEM, HIST 

COMMENT to check on path status and output 'after' listdev to spooler 

PUP /OUT SS. #PATH0.TWO /LISTDEV SSYSTEM 

COMMENT to primary to -mb and -b 

PUP PRIMARY SSYSTEM-MB 

PUP PRIMARY SSYSTEM-B 

COMMENT to test that path 

PUP LISTFREE SSYSTEM, HIST 

COMMENT to check on path status and output listdev to spooler 

PUP/OUT SS. #PATH0.THREE/LISTDEV SSYSTEM 

COMMENT ********************^^^******=fc*^^********** 

COMMENT end of obey file SSYSTEM.OBEY.PATHO 
COMMENT ***^****^******^**^**=f******x*^ + *^**^**^ + Jje ^ 


Figure 107.5. Obey File Ssystem.obey.patho 
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After the execution of Ssystem.obey.patho, the pup listdev for Ssys- 
tem should show that processor 0 is the primary path, and the asterisks 
should be next to $system-b and $system-mb. 

The next obey file, $system.obey.pathi, will switch the ownership of 
both disk controllers to processor 1, and test those paths. 

COMMENT ******************************************* 

COMMENT SSYSTEM.OBEY.PATH1 

COMMENT to check paths for processor 1 

COMMENT ******************************************* 

COMMENT to output 'before' listdev to spooler 

PUP /OUT 9S. #PATH1.ONE/LISTDEV 

COMMENT to primary paths to -p and -m 

PUP PRIMARY SSYSTEM-P 

PUP PRIMARY SSYSTEM-M 

COMMENT to switch controller ownership to processor 1 
PUP PRIMARY SSYSTEM,1 

COMMENT to test that path * 

PUP LISTFREE SSYSTEM, HIST 

COMMENT to check on path status and output 'after' listdev to spooler 
PUP /OUT $S.#PATHl.TWO /LISTDEV SSYSTEM 

COMMENT to primary to -mb and -b % 

PUP PRIMARY SSYSTEM-MB 
PUP PRIMARY SSYSTEM-B 
COMMENT to test that path 
PUP LISTFREE SSYSTEM, HIST 

COMMENT to check on path status and output listdev to spooler 

PUP/OUT $S. #PATH1.THREE/LISTDEV SSYSTEM 

COMMENT ******************************************* 

COMMENT end of obey file SSYSTEM.OBEY.PATH1 

COMMENT *************** **************************** _____ 

Figure 107.6. Obey File Ssystem.obey.pathi 

After the execution of Ssystem.obey.pathi, the pup listdev for Ssys- 
tem should show that processor 1 is the primary path, and the asterisks 
should be next to $system-b and Ssystem-mb. 

Writing Obey Files for Your System 

The above obey files are examples of one approach to testing controller 
paths. You will need to prepare obey files that reflect the configuration of 
your system. For instance, if you have multiple volumes on the same 
controllers, the obey files must reflect that. 

Obey files for other controllers would follow the same format. Note that 
executing a primary command does not ensure that the path is good. The 
path must be exercised (with a pup listfree Ssystem, hist in the case of 
the disk drives). A pup primary command only switches the path, it does 
not ensure that the path works after the switch. 

The pup listfree command is valid for exercising paths to the cdc 80 
and 300 mb Drives. A pup listdefects command must be used for cdc 
80,160 and 675 mb Winchester drives. 

To test disk controller paths, (as an alternative to the listfree or 
listdefects command) create a file and delete it. For instance, fup 
create Ssystem.test.path, followed by fup purge Ssystem.test.path 
would create a file, and then delete it, causing a read from one path and a 
write to both paths. A pup listdev after this command should show no 
change if the paths are good. 
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Analysis of Results 


It is important to regularly check the results of the obey file executions. 
In the case of the above obey files, the “before" and “after” state of the disk 
paths is stored in the spooling system with the following command: 

pup/out $s. #pathl.one/listdev $system 


You can use scan to analyze the results. 

As an alternative you could have the obey file output the listdev to the 
error logging device. In any case, the results of each obey file should be 
analyzed. 




107.5 


System Management Topics 


This page intentionally left blank. 


107.6 


System Management Topics 


Network Software Components 



SECTION 108 


Network Software Components 


The net node name is the same as the hardware configuration name. 
Each name is unique, and each begins with the backslash character (\). 

There are two types of network connections: 

1. Permanent—the physical connection is always in place (generally a 
leased line or own cable) 

2. Dial-up—the connection is temporary, using voice grade phone lines 

NETMON—Tandem Network Monitor Utility 

NETMON PROBE 

The netmon probe function checks and reports on all available (physi¬ 
cally connected) systems. It may be executed from Sil Command Inter¬ 
preter and displays information as illustrated in Figure 108.1. The 
information in the display is explained following the illustration. 


;netmon probe 

NETWORK MONITOR - T9057A06 - (01DEC83T1NOV83) 


TIME: 20 AUG 1985, 14:36:45 


NETPROBES AT \WP (052) 




1 \SII - * (00012) 

PROBE TO \SJ ** FAILED 250 ** 

8 \HDWR - \CLAS - \SII - * (00071) 

PROBE TO \HTEX ** FAILED 250 ** 

10 \CUSV - * (00007) 

11 \WASH - \WSHN - * (00022) 

PROBE TO \LAT ** FAILED 250 ** 

PROBE TO \LAOC ** FAILED 250 ** 

15 \WSHN - * (00019) 

PROBE TO \SF ** FAILED 250 ** 

PROBE TO \CTEX ** FAILED 250 ** 

19 \RAYEDIT - \WSHN - * (00021) 


Figure 108 . 1 . NETMON PROBE 


A single asterisk in the list (*) indicates the system from which netmon 
probe was executed (in this example, \wp. 

The number at the beginning of an entry is the node number. For example, 
in the entry “8 \hdwr," the node number is 8. 

Following the node number is the node name. For example, in the entry “8 
\hdwr,” the node name is “\hdwr.” 

The number at the end of the line is the number of “tics” (1/100ths of a 
second) to probe. 
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NETMON CPUS 

The netmon cpus function checks cpu status at all available (physically 
connected) systems. It may be executed from Sll Command Interpreter 
and displays information as illustrated in Figure 108.2. The information in 
the display is explained following the illustration. 


;netmon cpus 

NETWORK MONITOR - T9057A06 - (01DEC83T1NOV83) 

NETCPUS AT \WP (052) #PATHS = 32 TIME: 20 AUG 1985, 14:52:30 


SYSTEM 

0C--CPU STATES-->15 

NCP LVL 

1 \SII 

1111,_,_,_ 

10 

2 \SJ 

NOT CONNECTED 


8 \HDWR 

11. . ,.,. 

10 

9 \HTEX 

NOT CONNECTED 


10 \cusv 

10- .......... 

10 

11 \WASH 

NOT CONNECTED 


12 \LAT 

NOT CONNECTED 


13 \LAOC 

NOT CONNECTED 


15 \WSHN 

NOT CONNECTED 


17 \SF 

NOT CONNECTED 


18 \CTEX 

NOT CONNECTED 


19 \RAYEDIT 

NOT CONNECTED 



Figure 108.2. netmon cpus 

“1” in the display indicates that the cpu is up. 

“0” in the display indicates that the cpu down. 

A period in the display (.) indicates that the there is no cpu. 

Software Components Necessary 
for Network Operation 

In order for the network to operate between systems, the systems must 
be physically connected through modems and line handlers to a port on a 
Tandem byte sync controller. You can check this by executing pup list- 
dev type 63. A typical listing is illustrated in Figure 108.3. 


; pup 

listdev type 63 







LDEV 

NAME STATE 

PPID 

PCU 

BPID 

BCU DMNT TYPE 

SUBTYPE 

RECSIZE 

25 

SLHLINK-P 

01,016 

%202 

00,016 

%202 63 

0 

47 


SLHLINK-B 

01,016 

%203 

00.016 

%203 



26 

SLHHDWR-P 

01,017 

%204 

00.017 

%204 63 

0 

47 


Figure 108.3. pup listdev type 63 


To send messages or transmit stories to another logical system, you 
must have an entry for that logical system in your system desc list. There 
must be one record in the list for each logical system you wish to transmit 
to. This list supplies the message and burster software with the necessary 
logical system information. 

To display the list, execute |cmd| [x] and enter system desc in the list 
name field. 
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In order to transmit stories, you must also set up dest group records. 
These records identify the logical system of a specified group. 

To display the list, execute |cmd| 0 and enter dest groups in the list 
name field. 


A Summary 

There are five components of the net: 

1. Physical connection (modems and line handlers) 

2. GUARDIAN must know NEXTSYS 

3. REMOTE PASSWORDS 

4. system desc records 

5. dest groups records 

Depending on what you waht to do over 
some or all of these components. 

NETWORK FUNCTION 

network status, comint status commands 
run remote utilities (ci,fup,pup) 
send message to another system (cmd m) 

Transmit stories to another system (cmd , t) 


the net, you will need to set up 

Required Components 
1,2 

* 1,2,3 

1 , 2 , 3,4 
1,2,3,4,5 


Examples of Use of the Network 


:fup info hdwr.Ssystem. editor. * 

CODE EOF MODIF OWNER RWEP TYPE REC BLOCK 

HDWR.SSYSTEM.EDITOR 

ABBREV 24576 APR 16 254.255 NCN'C E 100 1024 

BASKET 0 21504 9:16 254,255 NCNC K 132 1024 

BURSTQ O 2048 APR 16 254,255 NCNC K 306 1024 


Figure 108.4. fup info for \hdwr.Ssystem.editor.* 

% 

:systemhdwr 
;ppd Szeus 

SYSTEM HDWR 

Name PID1 PID2 Parent Program file name 

SZEUS 01.031 00.048 HDWR SZ000 SSYSTEM .SII .SUPER2 


Figure 108.5. ppd for Szeus Proces on \hdwr 



Running a Remote Process 

In order to run a remote process as illustrated in Figure 108.6, the 
remote passwords must be set up on the \HDWR system. In addition, 
you may run into security violations, depending on how FUP is secured on 
the \HDWR system. 


: system HD\VR 
;run Ssystem.sys04.fup 

Figure 108.6. Attempting to Run A Remote Process (\hdwr.Ssystem.SYS04.fup) 

Note that the fup process was created by a \clas ci process and is 
still considered a remote process in process security checks. 
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Running Remote as a Local Process 

In the example in Figure 108.7, Sll Command interpreter is still local on 
\clas. If the logon to \HDWR is successful, the comint process and 
any processes created by that process will be considered local processes. 


system HDWR 
comint 

logon null.null 

fup _____ 

Figure 108.7. Running \hdwr.fup Remote as a Local Process 

The fup process is now created by \hdwr comint process. It is 
considered a local process in process security checks. 
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APPENDIX A 

Tandem File Management Errors 

This list of Tandem file management errors is provided for your refer¬ 
ence. You may also obtain these error descriptions while in Sll Command 
Interpreter by entering “error” followed by the error number (for example 
“error 121”) in response to the semicolon prompt. Note that when an error 
is logged, while running or attempting to run a utility, or in the aoprlog, 
leading zeros of the error number may be eliminated so that “error Oil” is 
logged as “error 11.” 

Numbers for which no error message has been assigned have been 
omitted from this list. 

000 operation successful 
001 end-of-file 

002 operation not allowed on this type file 

003 failure to open or purge a partition 

004 failure to open an alternate key file 

005 failure to provide sequential buffering 

006 system message received 

007 process not accepting control or setmode 

008 operation successful (examine mcw for additional status) 

010 fiie/record already exists 

011 file not in directory or record not in file 

012 file in use 

013 illegal filename specification 
014 device does not exist 

015 volume specification supplied does not match name of volume on 
which the file actually resides 
016 file number has not been opened 

017 paired-open was specified and the file is not open by the primary 
process, the parameters supplied do not match the parameters 
supplied when the file was opened by the primary, or the primary 
process is not alive 
018 system does not exist 
019 no more devices in logical device table 
020 attempt to open network file with long crtpid 
021 illegal (count) specified 

022 application parameter or buffer address out of bounds 
023 disk address out of bounds 
024 privileged mode required for this operation 
025 awaitio or cancel attempted on wait file 

026 awaitio or cancel attempted on a file with no outstanding opera¬ 
tions 

027 wait operation attempted when outstanding requests pending 
028 number of outstanding no-wait operations would exceed that speci¬ 
fied; or, attempt to open a disk file or Sreceive with maximum no. 
of concurrent operations greater than 1 
029 missing parameter 

030 unable to obtain main memory space for a link control block 
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031 unable to obtain shortpool space for a file system buffer area 
032 unable to find a large enough control block, or fileinfo called with 
-1 (file number) (any file) when no file was open 
033 i/o process is unable to obtain iopool space for an i/o buffer or 
(count) too large for dedicated i/o buffer 
038 operation attempted on wrong type of tns system 
039 server process received a request with a syncid older than the set 
of saved replies 

040 operation timed out. awaitio did not complete within the time speci¬ 
fied by its (time limit) parameter. If a od (time limit) (completion 
check) or -1 (file number) (any file) was specified, then the opera- . 
tion is considered incomplete. Otherwise, the operation is consid¬ 
ered completed 

041 checksum error on file synchronization block 

042 attempt to read from unallocated extent 

043 unable to obtain disk space for file extent 

044 directory is full 

045 file is full 

046 invalid key specified 

047 key not consistent with file data 

048 security violation 

049 access violation 

050 directory error 

051 directory is marked bad 

052 error in disk free space table 

053 file system internal error 

054 i/o error in disk free space table 

055 i/o error in directory 

056 i/o error on volume label 

057 i/o error in file label 

058 disk free space table is marked bad 

059 file is bad . 

060 volume on which this file resides has been removed or device has 

been downed since the file was opened 
061 no file opens are permitted 

062 volume has been mounted, but mount order has not been given, 
file open not permitted 

063 volume has been mounted and mount is in progress, file open not 
permitted 

064 volume has been mounted and mount is in progress, file open not 
permitted 

065 only special requests permitted 
066 device has been downed by operator 
070 continue file operation 
071 duplicate record 

072 attempt to access unmounted partition 
073 file/record locked 

074 readupdate called for Sreceive and number of messages queued 
exceeds (receive depth) - or reply called with an invalid (message 
tag) 

075 requesting process has no current process transid 
076 transid is in the process of ending 
077 a tmf system file has the wrong file code 


A.2 




Appendix A 


Tandem File Management Errors 


078 transid is invalid or obsolete 

079 attempt by transid to update or delete a record that it has not 
previously locked 

080 invalid operation on audited file or non-audited disk volume 
081 operation invalid for transid that still has no-wait i/o’s outstanding 
on a disk or process file 
082 tmf has not been started up 

083 attempt to begin more concurrent transactions than can be handled 

084 tmf has not been configured 

087 waiting on a read request and did not get it 

088 a control read is pending, new read invalid 

089 remote device has no buffer available 

090 transaction aborted by system because its parent process died 
091 transaction aborted by system due to database id inconsistency 
092 distributed transaction aborted by system due to network partition 
093 transaction spanning too many audit Files aborted by system 
094 transaction aborted by operator command 
097 transaction was aborted 

098 the Transaction Monitor Process’ Network Active Transactions ta¬ 
ble is full 

099 Enscribe option not installed 

100 device not ready 

101 no write ring 

102 paper out 

103 disk not ready due to power fail 

104 no response from device 

105 invalid vfu buffer 

110 only break access permitted 

111 operation aborted because of break 

112 read or writeread preempted by operator message 

120 data parity error 

121 data overrun error 

122 x.25 circuit reset, possible data loss 

123 sub-device busy 

124 a line reset is in progress 

130 illegal address to disk 

131 write check error from disk 

132 seek incomplete from disk 

133 access not ready on disk 

134 address compare error on disk 

135 write protect violation with disk 

136 unit ownership error (dual-port disk) 

137 controller buffer parity error 

138 interrupt overrun 

139 controller error or last disk error 

140 modem error (communication link not yet established, modem fail¬ 
ure, momentary loss of carrier, or disconnect) 

145 card reader motion check error 

146 card reader read check error 

147 card reader invalid Hollerith code read 

150 end-of-tape marker detected 

151 runaway tape detected 

152 unusual end - tape unit went off line 
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153 tape drive power on 

154 bot detected during backspace files or backspace records 

155 only nine track magnetic tape allowed 

156 til protocol violation detected 

157 i/o process internal error 

158 invalid thl function code used 

160 request is invalid for line state 

161 impossible event occurred for line state 

162 operation timed out 

163 eot received 

164 disconnect received 

165 rvi received 

166 enq received 

167 eot received on line bid 

168 nak received on line bid 

169 wack received on line bid 

170 no id sequence received during circuit assurance mode 

171 no response received 

172 reply not proper for protocol 

173 maximum allowable naks received 

174 wack received 

175 incorrect alternating ack received 

176 poll sequence ended with no responder 

177 text overrun (insufficient buffer space for data transfer) 

178 no address list specified 

179 application buffer is incorrect 

180 unknown device status received 

181 status receipt currently enabled for subdevice 

190 invalid status received from device 

191 device power on 

192 device is being exercised 

193 invalid or missing microcode file 

200 device is owned by alternate port 

201 the current path to the device is down or an attempt was made to 
write to a non-existent process 

210 device ownership changed during operation 

211 cpu performing operation failed during operation 

212 eio instruction failure 

213 channel data parity error 

214 channel timeout 

215 i/o attempted to absent memory page 

216 map parity error during this i/o 

217 memory parity error during this i/o 

218 interrupt timeout 

219 illegal device reconnect 

220 protect violation 

221 pad-in violation 

222 bad channel status from eio instruction 

223 bad channel status from no instruction 

224 controller error 

225 no unit or multiple units assigned to same unit number 

230 cpu power failed then restored 

231 controller power failed then restored 
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240 

241 
246 

248 

249 

250 

251 


network line handler error, operation not started 

network error, operation not started 

external cluster bypass error, operation aborted 

network line handler error, operation aborted 

network error, operation not started 

all paths to the system are down 

network protocol error 
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UTILITY 

AID 

LOCATION/DESCRIPTION 

Tandem (unsupported) 

Interprets console messages from log file 

AUDPURGE 

System Manager’s Manual 

Purges audit copies 

B 

System Manager's Manual 

Lists busy devices or users or summary of device activity 

BACKUP 

Tandem Guardian Operating System Command Language 
Utilities Manual 

Backup disk files to magnetic tape 

BUILD 

Sll (not documented) 

Produces update tape 

BUILDVC 

Sll (not documented) 

Used to alter vcontrol responses 

/~\ CABUPD 

Advertising Management Manual 

Classified Billing Update 

CDUMP 

Advertising Management Manual 

Classified Dump to Photosetter 

CHARGEN 

Keyboard Configuration Manual 

Loads site's Keyboard Table 

CHAROTE 

Keyboard Configuration Manual 

Loads site's Character Set 

Cl 

System Manager’s Manual 

SH’s Command Interpreter 

CLASSB 

Advertising Management Manual 

Classified Billing Info to Foreign System 

COMINT * 

Tandem Guardian Operating System Command Language 
Utilities Manual 

Create Tandem users/start & stop processes 

CORED 

System Manager's Manual 

Dumps file in hexadecimal format 

CRUTIL 

Advertising Management Manual 

Update System 55 with info from Foreign System 

CUP 

Tandem AXCESS—Volume 1 

Manipulation of network i o devices 
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UTILITY 

LOCATION/DESCRIPTION 

CUSF1X 

Advertising Management Manual 

Create and Delete Customer Information Records 

DCOM 

Tandem Disc Space Analysis and Disc Compression Utili¬ 
ties Manual 

Disk free space compression utility 

DEBUG 

Tandem Debug Reference Manual 

Interactive debug utility 

DELAY 

Tandem Guardian Operating System Command Language 
Utilities Manual 

DELTEMPS 

For pauses in program execution 

Sll—not documented 

Deletes temporary disk files 

DICT 

Editorial Manager’s Manual 

Dictionary maintenance process 

DISKINFO 

System Manager’s Manual 

Info on number of bytes and files in a subvolume 

DSAP 

Tandem Disc Space Analysis and Disc Compression Utili¬ 
ties Manual 

Disk space analysis utility 

DSTAT 

System Manager's Manual 

Reports collected vdt statistics 

% DIVER 

Tandem Guardian Operating System Command Language 
Utilities Manual 

DUMPSUMM 

Causes processor to fail for testing purposes 

Advertising Management Manual 

Updates ads after Classified Dump 

EDIT 

Tandem EDIT Manual 

Text editor 

EPNTAPE 

Sll 

For database conversions 

ERROR 

Tandem Guardian Operating System Command Language 
Utilities Manual 

Displays description of file management error 

FGEN 

Form and List Generation Manual 

Sll Forms Generator 

FIND 

System Manager’s Manual 

Gives all volume.subvolume names for a file 

FIXCHAR 

Device and Font Management 
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UTILITY 

LOCATION/DESCRIPTION 

vdt character library maintenance process 

FIXER 

System Manager’s Manual 

Fixes data files 

FMOD 

Device and Font Management 

Font and Device definition and maintenance 

FORMAT 

Advertising Management Manual 

Reformats disk files 

FSTAT 

System Manager’s Manual 

Lists processes ihat have a file open 

FTM 

System Manager's Manual 

Modifies ftm parameters 

FUP 

Tandem Operating System Command Language and Utili¬ 
ties Manual 

Create, copy disk files and disk file security 

GCOPY 

Form and List Generation Manual 
fgen/lgen copying program 

GLOSS 

Glossary Manager's Manual 

Defines glossary keys 

GSTAT 

System Manager’s Manual 

Collects VDT statistics 

INSPECT 

Tandem INSPECT Debugger User’s Guide 

Interactive program debug utility 

LGEN 

Form and List Generation Manual 

Sll List generator program 

LINKUP 

System Manager’s Manual 

Gives file revision level information 

MAINT 

System Manager's Manual 

Basket, desk, tear sheet, blind box, and extract file mainte¬ 
nance 

MAPGEN 

MAPGEN User's Manual 

Data transmission format definition 

MUX 

System Manager's Manual 

Manipulates parameters for tcus/vcus 

NETMON 

Expand Users Manual 

Displays network status 

PAGED 

Editorial Manager’s Manual 

Interactive editorial page dump process 

PERCENT 

System Manager's Manual 
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UTILITY 

LOCATION/DESCRIPTION 

Prints text file information 

PEEK 

Tandem System Operations Manual 

Displays system resource usage 

PIPE 

System Manager’s Manual 

Transfers stories from one system to another 

PMORT 

Advertising Management Manual 

Verification of Classified Dump 

PRINT 

System Manager’s Manual 

Writes a message to a device 

PRINTH 

System Manager’s Manual 

Writes a high priority message to a device 

PROGREV 

System Manager’s Manual 

Reports file revision level information 

PSTAT 

System Manager’s Manual 

Prints process control block information 

PUP 

Tandem System Operations Manual 

Control of hardware I/O devices 

Q 

Index of Record Structures 

Q-field definition and maintenance 

QREQUEST 

System Manager’s Manual 

Executes request functions with English statements 

READYQ 

System Manager’s Manual 

Shows processes waiting to run on a cpu 

REAUDIT 

System Manager's Manual 

Reformats audit copies with new header structure 

REPLACE 

Sll (not documented) 

For software updates 

REQUEST 

System Manager’s Manual 

Sends parameters to a process 

RESTORE 

Tandem Guardian Operating System Command Language 
Utilities Manual 

Restore disk files from magnetic tape 

RGEN 

Report Generation Manual 

Sll Report Generator Program 

RSCHED 

Report Generation Manual 

Report Scheduler 

SCAN 

System Manager's Manual 

Spooling file monitor and manipulation process 
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UTILITY LOCATION/DESCRIPTION 

schedset System Manager's Manual 

Program scheduler 

seomgen Input Spooling System Manual 

Modifies or creates seom file 


SITEGEN 

SOFTGEN 

SPEDIT 

SPOOLCOM 

STYl 

STTY 

TAPE 

TCOPY 

TDUMP 

TEXTGEN 

VDTSTATS 

VDTGEN 

VUP 

XRAYCOM 

XRAYSCAN 

XTM 


How to Write STYLs Manual 
Defines site-specific styl variables 

Keyboard Configuration Manual 
Produces soft key object code file 

Editorial Manager’s Manual 
Spelling Utility 

Tandem Spooler System Management Guide 
Provides interactive spooler control 

STYL Manual 

Sll typesetting markup language 

System Manager’s Manual 

Modifies Asynchronous device communications 

parameters 

System Manager’s Manual 
Stores and recovers takes on tape 

System Manager’s Manual 

Copies text from any input source into a take 

System Manager's Manual 
Take Dump 

Input Spooling System Manual 
Text conversion process 

System Manager's Manual 

Provides statistics on directory requests for tuning header 
extracts 

System Manager’s Manual 

Allows changes to config records for vcontrol processes 

System Manager's Manual 
vdt utility process 

Tandem XRAY Users Manual 
Monitors system performance 

Tandem XRAY Users Manual 
Monitors system performance 

System Manager’s Manual 
Modifies parameters for xtms 
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APPENDIX C 

Sil Processes 

The standard System/55 named processes are listed in this section. The 
process names are not fixed, and may be different on your system. 


System Processes 


NAME 

DESCRIPTION 

ANCESTOR 

$ZEUS 

Sll System overseer 

$Z000 

$2000 

First Tandem command interpreter 


SCNSL 

Command interpreter on SConsole 

Szooo 

$CMON 

Command interpreter program priority monitor 

Szooo 

$DNA 

Download process for vcu/tcu and terminals 

Szooo 

$DNF 

Download process for ftm and terminals 

Szooo 

$STAT 

System statistics collecting process 

Szooo 

Saopr 

Application operator message process 

Szooo 

$SPLS 

Spooling system supervisor process 

Szooo 

$S 

Spooler collector 

$SPLS 

$RPRT 

Spooler print process 

$SPLS 

$JOBS 

Spooler print process 

$SPLS 

$SPLP 

Spooler line printer driver process 

$SPLS 

$SCHD 

System scheduling process 

$ZEUS 

Swrap 

ap Wire service collection process 

$ZEUS 

SlSPL 

Input spooling system supervisor process 

Szooo 

$IP 

Primary spooler collector 

$ISPL 

$IB 

Backup spooler collector 

SlSPL 

$INSV 

Input spooler print process 

SlSPL 

$INTK 

Input line handler 

Szooo 

$INMN 

Wire input system monitor 

$ZEUS 

$ISTAT 

Wire input statistics process 

Szooo 

Simon 

Inspect monitor supervisor 

Szooo 

Sdmoo 

Inspect monitor for CPU o 

Simon 

$DM0(XX) 

Inspect monitor for cpu xx 

Simon 
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NAME 

DESCRIPTION 

ANCESTOR 

$CAJ1 

aps text justification process 

$CGOD 

$CAH1 

aps trial-set/head-fit justification process 

$CGOD 

$CAP1 

aps output module process 

$CGOD 

$CDUP 

Take or ad duplication (sending) process 

$ZEUS 

$CBRT 

Take or ad duplication (sending) process 

$ZEUS 

$CRCV 

Take or ad receiver process 

$ZEUS 

$CFIL 

Filtering process 

$ZEUS 

$CHYF 

Text hyphenation process 

$ZEUS 

$CSPL 

Text spelling process 

$CGOD 

SCMSG 

Message sending process 

SZEUS 

$CVGT 

Virtual Get (read) process for forms 

SZEUS 

$CVPT 

Virtual Put (write) process for forms 

SZEUS 

$CUPD 

Header update process 

SZEUS 

$CSVE 

Text save process 

$CGOD 

$CDTA 

Data output process 

SCGOD 


c.i 
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NAME 

DESCRIPTION 

ANCESTOR 

$CPRF 

Text proof process 

$CGOD 

$CPRG 

Text purge process 

$ZEUS 

$CFIO 

File Input/Output process 

$ZEUS 

$CTW 

Text write process 

$ZEUS 

$CTR 

Text read process 

SZEUS 

$CGOD 

Classified system overseer process 

$ZEUS 

$CVPM 

Classified prompt process 

$ZEUS 

$CRCK 

Classified credit check 

$ZEUS 

$CLIN 

Classified linage estimator 

Editorial System Processes 

$ZEUS 

NAME 

DESCRIPTION 

ANCESTOR 

$EAJ1 

aps text justification process 

$EGOD 

$EAJ2 

aps text justification process 

$EGOD 

$EAH1 

aps trial-set/head-fit justification process 

$EGOD 

$EAP1 

aps output module process 

$EGOD 

$EQMJ 

qume™ text justification process 

$EGOD 

$EQMH 

qume trial-set/head fit justification process 

$EGOD 

$EQUM 

qume output module process 

$EGOD 

$EDUP 

Take or ad duplication (sending) process 

$ZEUS 

$EBRT 

Take or ad duplication (sending) process 

$ZEUS 

$ERCV 

Take or ad receiver process 

$ZEUS 

$EF1L 

Filtering process 

$ZEUS 

$EHYF 

Text hyphenation process 

$ZEUS 

$ESPL 

Text spelling process 

$EGOD 

$EMSG 

Message sending process 

$ZEUS 

$EVGT 

Virtual Get (read) process for forms 

$ZEUS 

$EVPT 

Virtual Put (write) process for forms 

$ZEUS 

$EUPD 

Header update process 

$ZEUS 

$ESV1 

' Text save process 

$EGOD 

$ESV2 

Text save process 

$EGOD 

$EDTA 

Data output process 

$EGOD 

Seprf 

Text proof process 

$EGOD 

Seprg 

Text purge process 

$ZEUS 

$efio 

File Input/Output process 

$ZEUS 

$ETW 

Text write process 

$ZEUS 

Setri 

Text read process 

$ZEUS 

$ETR2 

Text read process 

$ZEUS 

$EGOD 

Editorial system overseer process 

$ZEUS 

$EBAT 

Editorial batcher process 

SZEUS 

$EVPM 

Editorial prompt process 

SZEUS 
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Process Types 

Process types that are used in the configuration file record for a process 
are listed below. See Section 43 for an explanation of the configuration file 
record. 


PROCESS TYPE 

DESCRIPTION 

0 

Disk file—not a process 

1 

God process 

2 

Utility process 

3 

God server process 

4 

vdt process 

5 

Text write process 

6 

Text read process 

7 

Message process 

8 

Form process 

9 

Super process 

10 

Header update process 

11 

Wire process 

12 

File i/o process 

13 

Hyphenation process 

14 

Spell process 

15 

Page dump process 

16 

Wire carbon process 

17 

Validation process 

18 

pd line handler 

19 

Duplication process 

20 

Receiver process 

21 

Input monitor process 

22 

Filter parser 

23 

Story burster process 

24 

Output monitor 

25 

Prompt process (vputget) 

26 

Spanish hyphenation process 

27 

German hyphenation process 

28 

Typesetter control 

29 

sched process 

30 

Linage accumulator 

31 

Credit checking process 

32 

Segregated header process 
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0 

1 


1 

2 

2 

3 

3 

4 

4 

5 

5 

6 
7 

7 

8 
8 
9 
9 

10 

10 

11 

11 

12 

12 

13 

14 

15 

16 
18 

19 

20 
21 
22 
23 

23 

24 

24 

25 

25 

26 

27 

28 

29 

30 

31 


PROGRAM file 

(disk data file) 

«>SYSTEM.EDITOR.HEADER 
5SYSTEM.CLASS.HEADER 

Ssystem.editor.textf 

$SYSTEM. CLASS. TEXTF 
^SYSTEM.EDITOR, users 
$SYSTEM. CLASS. USERS 
5SYSTEM.EDITOR.DESK 
$SYSTEM.CLASS. DESK 
Ssystem. editor, basket 
$SYSTEM. CLASS. BASKET 
Ssystem. class, custinfo 
Ssystem . editor . m sgfile 
Ssystem.class.msgfile 

Ssystem. editor, lmsg 
Ssystem.class, lmsg 
Ssystem. editor, fmsg 
Ssystem.class.fmsg 
Ssystem.editor.strings 
Ssystem.class.strings 
Ssystem.editor.list 
Ssystem.class.list 
Ssystem.editor.form 
Ssystem.class.form 
Ssystem.q.qfield 
Ssystem.q.crossref 
Ssystem.sysdata.devtable 
Sstat 

Ssystem.sii.variable 
Ssystem.sii.constant 
Ssystem.sii.operands 
Ssystem.sii.keywords 
Ssystem.editor.stylcode 
Ssystem.editor.styundx 
Ssystem. class, stylindx 
Ssystem.editor.stylspce 
Ssystem. class, stylspce 
Ssystem.editor.styldesc 
Ssystem.class.styldesc 
Ssystem. sysdata.sysdesc 
Ssystem.sysdata.devdesc 
Ssystem. editor.wtime 
Ssystem. editor.whead 
Ssystem.editor.wkeywd 
Ssystem.chargen.chars 


of the configuration fi/e 

DESCRIPTION 

Process creation 
editorial header file 
Classified header file 
Editorial text file 
Classified text file 
Editorial users file 
Classified users file 
Editorial desk file 
Classified desk file 
Editorial basket file 
Classified basket file 
Classified customer information (cir) 
Editorial message file 
Classified message file 
Editorial list message file 
Classified list message file 
Editorial form message file 
Classified form message file 
Editorial save string file 
Classified save string file 
Editorial list save file 
Classified list save file 
Editorial form save file 
Classified form save file 
Q-Field file 

Q-Field/structure cross reference file 

Device information file 

vdt statistics process 

STYL variables file 

styl constants file 

styl operands file 

styl keywords file 

styl object code file 

Editorial styl object code index file 

Classified styl object code index file 

Editorial styl object code space file 

Classified styl object code space file 

Editorial styl object code description file 

styl object code description file 

System description file 

vdt descriptions file 

Wire time file 

Wire header file 

Wire keyword file 

Character library file 
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RECORD 

oo ^SYSTEM* MATXBE 

* V-rr 


S $systhm^ss.cbeo>t 

36 SS«;“ E c D h '™^CRRR»^ 

36 $SYS !.p^'cHARGEN. GRAPHICS 
37 SS«TEM'cDASS_aA3SC 

* S&-S 

,n LysTEM.SCHED.GROUPS 

“ $SySTE W .SC H DD.PROORAMS 

42 Ssystem.class.rates 

43 $SYSTEM.CLASS. ADTYPEC 

44 $SYSTEM.CLASS.CASH 

45 $SYSTEM. CLASS. PUBGRO 

46 SSYSTEM.SYSDATA.SUBD 

46 $SYSTEM.SYSDATA.SUBDEV 

47 $SYSTEM.CLASS. SlTEVARS 

47 $SYSTEM .EDITOR .SlTEVARS 

48 $SYSTEM.CLASS.BOX 

49 $SYSTEM.CLASS.TEARS 

50 $SYSTEM. CLASS. BILLFILE 

51 $SYSTEM.CLASS. DUMPITEM 

52 $SYSTEM. EDITOR. WTABCODE 

53 $SYSTEM.SYSDATA.VSTOP 

54 $SYSTEM. EDITOR. RELEASE 

55 SSYSTEM.DICT.MASTER 

55 SSYSTEM.DICT.MASTER 

56 SSYSTEM. EDITOR. WSTATUS 

57 $SYSTEM. DICT.SPELLH 

57 $SYSTEM.DICT.SPELLH 

58 SSYSTEM. DICT.SPELLW 

59 SSYSTEM.DICT.REFER 

60 $SYSTEM.SCHED.TIMES 

61 $SYSTEM.CLASS.BASKETGP 

62 SSYSTEM.EDITOR.WCARBON 

63 SSYSTEM.CLASS.STATSOL 

64 SSYSTEM.CLASS.STATACC 

65 SSYSTEM.CLASS.STATCLAS 

66 

67 SSYSTEM.COYOTE.CLASSMAT 

67 SSYSTEM. COYOTE. LOCALMAT 

68 SSYSTEM. EDITOR. WCONTROL 

69 SSYSTEM.SYSDATA.AOPRGRP 

70 SSYSTEM.COYOTE.ATTRIB 

71 SSYSTEM.SYSDATA.AOPRLOG 

72 SSYSTEM. EDITOR. DIGINF 

73 SSYSTEM.EDITOR.DIGIPROC 

74 SSYSTEM.EDITOR.EHELP 

74 SSYSTEM.CLASS.CHELP 

75 SSYSTEM.EDITOR.PVALID 

76 SSYSTEM.EDITOR.RECOVERY 

77 SSYSTEM. EDITOR. EDITIONS 

78 SSYSTEM. EDITOR. METHOD 


s»-: 

Local et/960 matrix 
Bad credit tile 
x yzz table data 
Printer graphic tile 
Printer graphic 
’Classes' tile 
^ohedset Users 

schedset program groups 

Classified rates tile 

S 'cash transaction file 

Pub group file 

Film group file 

Film group file 

Classified styl site variables 

Editorial styl site variables 

Blind box file 

Tear sheet file 

Billing file 

Classified dump item file 
Wire tabcode file 
vdt stop file 
Released page file 
Master dictionary 
Master dictionary 
Wire status file 
Spell story summary 
Spell story summary 
Spell word list 
Dictionary referals 
Scheduled program times 
Classified baskets groups 
Wire carbon data file 
Solicitor statistics file 
Account statistics file 
Classified statistics file 
Remote access file 
Classified Coyote matrix file 
Coyote matrix file 
Wire control file 
aopr group file 
Coyote attribute file 
aopr log file 
Digital Stocks info file 
Digital Stocks process 
Editorial Coyote soft-key help file 
Classified Coyote soft-key help file 
Form validation info 
pd recovery file 
pd editions file 

Editorial directory method file 
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recordt ? 8 r° GR — 

79 S; s ; e :^ ss --hod 

79 $SYSTEUr R0UTL0G 

80 $SYSTPm' CUSS - OUTLog 

81 $!ysrEMrn Y ° TE - FUNT ^ 

82 SSYSTPM Pn Y ° TE ED ' TKEY 

83 $systpm' ED,T0R ' 0upgrp 

84 $ SYST ^- EDIT0R - DU ^ ST 

85 $ SYSTEMr LASS - FCDATA 

" i ^: z : scha ^ 

aa to££Zn Sa - Boxn *- Y 

88 $SYs2m? ° aUSERGRP 

89 Ssystpm = USS ' USERGRP 

90 $Jystp* D,T0R ' BUSTq 

91 S v Y i TEM£D(TOR -VUPlNFO 

92 Co Y c T EM CUSS ’ 0EADUne 
q~ f SYSTEM -8DlTOR.ILINCHAR 
yj SSYSTEM.COYOTE. VARTAB 
94 SSYSTEM.EDITOR.EXTRACT 

94 $SYSTEM. CLASS. QEXTRACT 

95 $SYSTEM. CLASS. SEQUENCE 

96 $SYSTEM. PAGE. LAYOUT 

97 SSYSTEM.CLASS. ADJUST 

98 $SYSTEM.CLASS.TRACKING 


99 SSYSTEM.CLASS.SPECRATE 

100 SSYSTEM.CLASS.CLDEPT 

101 SSYSTEM.CLASS.PAYMENTS 

102 SSYSTEM.CLASS.CLR 

103 $SYSTEM.CLASS.EXTRACTO 

104 SSYSTEM.EDITOR.XBASKET 

105 

106 SSYSTEM.CLASS.SOFTKEY 

106 $SYSTEM.EDITOR.SOFTKEY 

107 

108 SSYSTEM.RGEN.SOURCE 

109 $SYSTEM.CLASS.SALES 

110 $SYSTEM.CLASS.CONTROL 

111 SSYSTEM.CLASS.ACCTYPE 

112 SSYSTEM. EDITOR. MAPOBJ 

112 $SYSTEM.CLASS.MAPOBJ 

113 SSYSTEM.EDITOR.CONV 

113 SSYSTEM.CLASS.CONV 

114 SSYSTEM.EDITOR.SEOM 
11 5 SlSTAT 

116 $SYSTEM.CLASS.DSTGRPS 

116 SSYSTEM.EDITOR.DSTGRPS 

117 $OSTAT 

118 $SYSTEM.EDITOR.INROUTE 

119 SSYSTEM. EDITOR. MXREF 

120 SSYSTEM.EDITOR.ILSTATUS 

121 SSYSTEM.CLASS.BURSTQ 

121 $SYSTEM.EDITOR.BURSTQ 

122 SSYSTEM.SYSDATA.PRIORTY 

123 SSYSTEM.CLASS.ECCHAR 

123 SSYSTEM.EDITOR.ECCHAR 

124 SSYSTEM.EDITOR.OLSTATUS 


Record Typg. 

DESCRIPTION 

hod " h 

coyStSS 109 

Coyote keyboard 
Dup group file 

oop destination file 

cSarssr da,a 

Blind prcgrarr/ Me 

aJl° r i a ' USer 9 rou P file 

Fnfn"f d . USer grou P file 
Editorial “bust” request queue 

vup sign-on information Q 

Classified deadlines file 
nput Line Characteristics file 
Coyote variable table 
Editorial Q-Field extract 
Classified Q-Fieid extract file 
Classified sequence tables 
Pagination layout 
Classified adjustments file 
Ad tracking file 
Special classified rates 
Classified user department 
Payment transactions 
Credit limit records 
Active classified header extract file 
Header extract file 
Hit list for Coyotes 
Coyote soft keys for Classified 
Coyote soft keys for Editorial 
Special header extracts 
rgen source file 
Sales transactions 
Class control file 
Account type file 
Editorial mapgen object code file 
Classified mapgen object code file 
Editorial textgen character table 
Classified textgen character table 
som/eom file 

Input Line Statistics Process 
Classified destination groups 
Editorial destination groups 
Output line statistics Process 
Input routing file 
mapgen cross reference file 
Dynamic Input Line Status file 
Classified burst request queue 
Editorial burst request queue 
Priority table 

Classified control characters 
Editorial control characters 
Dynamic Output Line Status file 
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record TYPE 
125 

125 

126 

127 

128 

129 

130 

131 

132 

133 

133 

134 

135 

136 

137 

138 

139 

140 

141 
143 

143 

144 

145 

146 

147 
143 


Ssystem r rt ^ B 

SEEKS*? 

SSYSTEW.EDmn.LOSO 
$SYSTEM.EDITOR-TCSELE 

$SYSTEM.CLASSPAG.RPARS 
$SYSTEM.CLASSPAG.CPARS 
$SYSTEM. EDITOR.TCINF0 
$SYSTEM. EDITOR. PR00FKEY 
$SYSTEM. CLASS. PROOFKEY 
$SYSTEM.AD.LINAGE 


SSYSTEM. CLASS. COMMANDS 


sss»r 

sr-'-su— 

User response jcs We 

SeJectionNalid^ion d extfact definition 
Classified heade '□ traCt definition 

S 2 MS* 

TypesettemtnTCl selections 

Bar code history 

Bar code configuration 

Classified pagination run parameters 

Classified pagination class parameters 

Typesetter control information 

proof process key-to-device file 

proof process key-to-device file 

Linage summaries 

Rate holder table 

Copy change records 

f"' nnrlp r>l n eoifioH naninQtinn 
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APPENDIX F 

Standard Subvolumes 


SUBVOLUME 

SITE SPECIFIC? 

PURPOSE OF FILES IN SUBVOLUME 

IN UPDATE? 

ASSIST 

NO 

Misc System Diagnostics and Help 

YES 

CHARGEN 

YES 

Site Character Sets 

NO 

CLASS 

YES 

Site-specific Data Files 

NO 

COYOTE 

NO 

(may require reformatting after update) 

Coyote Terminal Programs 

YES 

DICT 

YES 

(must preserve site specific keyboard files in update) 
Dictionary Files 

NO 

EDITOR 

YES 

Site-specific Data Files 

NO 

EXERCISE 

NO 

(may require reformatting after update) 

Real time System Exercises 

YES 

FONTXXXX 

YES 

Font & Recode Data Files 

NO 

GA 

NO 

All ga 220 Download Programs 

YES 

INPUT 

YES 

Wire Input Obey Files 

NO 

M68 

NO 

Coyote & tcu Programs 

YES 

OBEY 

YES 

System Obey Files 

NO 

Q 

YES 

All Program Structures 

NO 

SCHED 

YES 

Scheduling Data Files 

NO 

SH 

NO 

Sii Application Software 

YES 

SPL 

YES 

Spooler Data Files 

NO 

SYSDATA 

YES 

Site-specific Data Files 

NO 

SYSTEM 

NO 

Tandem & SII System Software 

YES 

SYSEX 

NO 

System Diagnostics 

YES 

SYSXX 

NO 

Tandem Operating System Software 

YES 

VPEND 

YES 

Process Spooling Files 

NO 

Z2XXXX 

NO 

System Diagnostics (dedicated cpu) 

YES 
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Boldface page numbers indicate primary discussions of subjects. 


S 

SCONF, 40.1 
SDNA—see download 

A 

ACTIVATE, 66.3 
active ad extract file, 61.3 
ADD. 89.6 

advertising header extract 
records, defining, 61.4 
advertising header extract 
types, 61.3 

advertising header extract, 
configuration file entry 
for, 61.4 

advertising header extract, 
defining, 61.5 

advertising header extracts, 
deleting, 61.7 

advertising header extracts, 
maintaining, 61.7 
AFTER, 86.13 
ALTPRI, 66.4 
AOPR. 8.1.81.3, 99.13, 

104.1 

AOPR log, 8.5 
AOPR log file, paths, 8.3 
AOPR run command. 8,2 
application processes, 2.2 
application programs, 2.2 
APS. 9.1 
APS Driver. 9.1 
audit copies. 64.1 
audit copy purge process, 

64.1 

audit copy purge 
process—see 
AUDPURGE 
AUDPURGE. 64.1 
AUDPURGE parameters, 
64.2, 64.4 

AUDPURGE run command, 

64.2 

auto purge process—see 
PURGE 

automatic memo 

process—see MEMO 

B 

b process, 65.1 
backup process, 2.4 
basket file. 46.1 
batch process. 10.1 
BATCHER, 10.1 
battery-backup. 1.4 
BURSTER. 11.1 
busy—see b process 
byte-synchronous controller, 
1.9 

c 

CCONTROL. 7.1. 13.1, 

101.2 

CGOD. 2.1.6.1,6.2, 43.1, 

64.1 

CLEAR. 89.5 
CMON. 12.1 
coldstart. 100.1 
collector. 86.10 


COMINT, 2.3, 97.1,97.2, 
97.4 

command interpreter, 87.1 
command interpreter 
monitor—see CMON 
configuration file, 5.1, D.1, 
E.1,43.1,61.4, 93.1 
configuration file, paths 
through, 43.3 
CON F—see VSTART 
console, 1.3 
COPIES, 86.13 
Coyote, 1.8 
Coyote build revision 
information, 80.2 
Coyote 1,1.8 
Coyote IV, 1.8 
Coyote QB, 1.8 
Coyote R, 1.8 
Coyote STD, 1.8 
Coyote terminals, 

troubleshooting, 103.1 
CPU, 1.3, 1.4, 1.6, 66.9 
CPU BUSY, 101.2 
CPU halt, procedures 
during, 105.1 

CPU QLEN, 101.2, 101.12 
CRCHECK, 13.1 
CREATE, 66.4 
credit check process—see 
CRCHECK 

CUPDATEH, 13.1, 14.1, 

14.3,34.1 

D 

DATA. 15.1 
data files, 42.1 
data files, structured. 42.2 
data files, unstructured. 42.2 
DATA print process. 15.1 
DATE. 86.11 
DELETE. 86.16 
deleting jobs—see DELETE 
desk file, 47.1 
DEVICE. 86.17 
device information file, 56.1 
device names. 2.4 
disk activity, 101.1 
disk drives. 1.6 
disk file names. 3.2 
disk head crashes. 102.2 
disk pack storage and 
handling, 102.1 
disk pack, avoiding 

contamination of. 102.1 
DISK RATE. 101.2 
DISKINFO, 67.1 
DNA. 2.3 
DNF. 2.3 
DOWNLD. 16.1 
download. 58.1. 99.4, 99.14 
download process. 2.3 
download—see DOWNLD 
DSTAT. 68.1 
Dynabus. 1.3 


E 

ECONTROL, 7.1,99.5, 

101.2 
EDIT, 2.3 

editorial header extracts, 

61.8 

editorial header extracts, 
configuration file entry 
for, 61.9 

editorial header extracts, 
defining, 61.9, 61.10 
editorial header extracts, 
deleting, 61.11 
editorial header extracts, 
maintaining, 61.10 
EGOD, 2.1,6.1,6.2, 43.1, 

64.1 

EMSG, 26.1 
EOT, 89.5 
EP, 17.1 

error messages, 106.1 
EXECUTE. 94.6 
exiting Sll command 
interpreter, 66.2 
EXPAND network, 1.10 
extended processes—see 
EP 

extract files, advertising 
header, 61.3 
extracts, 61.1,61.2, 92.3 

F 

FALL, 86.13 
fault tolerance. 1.1 
FGEN, 52.1 

file I/O process—see FIO 
file management errors, A.1 
file management system, 2.2 
file ownership, 97.8 
file security, 104.1 
file statistics process, 71.1 
FILES, 66.5 
files, securing, 97.5 
FILTER, 17.1 

filter process—see FILTER 

FIND, 69.1,86.12 

FIO, 18.1 

FIXER. 70.1 

FMSG. 55.1 

FORM. 86.8. 86.10 

form. 86.14 

form file. 55.1 

form name. 86.7 

form names. 86.2 

FSTAT. 71.1 

FTM. 1.9 

FUP, 2.3. 97.5.97.8 

G 

group. 86.16 

GSTAT. 19.1.92.1. 101.7 
GUARDIAN. 2.1.2.2 

H 

H&J. 20.1.23.1 
hardware architecture. 1.1 
hardware overview. 1.1 
head crashes. 102.2 
header extracts. 61.2 


header file. 44.1 
header update 
processes—see 
UPDATEH, CUPDATEH 
help, 86.5 
HOLD, 86.13 
hold-after—see AFTER 
HYPHEN, 20.1,23.1 
hyphenation process—see 
HYPHEN 

i 

I/O balancing, 101.2, 101.11 
I/O controllers, 1.3,1.4.1.6 
IDETAIL, 86.7 
IN, 66.9 
INMON, 21.1 

input monitor process—see 
INMON 

Intelligent Patch Panel, 1.10 
Inter-Processor Bus, 1.3 
IPB—see Inter-Processor 
Bus 
IR1,1.10 

J 

JFORM, 86.7 
job. 86.8 

job display width—see 
STARTCOL, NUMCOL 
job location, 86.2. 86.6 
job location mask, 86.8 
job number, 86.2 
job selection mask, 86.7, 
86.11 

JOBS. 22.1, 86.9 
jobs, listing—see listing jobs 
jobs, selecting—see 
selecting jobs 
JREPORT, 86.7 
JUST, 14.1,23.1,56.1 
justification process—see 
JUST 

K 

KILL, 94.6 

L 

LGEN.52.1 
LHEX. 86.15 
LINAGE. 24.1 
lineage total update 
process—see LINAGE 
LINKUP. 73.1 
LIST. 89.3 
list. 86,14.86.15 
list file. 54.1 

listing job contents—see list 
listing jobs. 86.6 
LMSG. 54.1 
LOAD, 89.6 

LOCATION. 86.9.86.13 
location, job—see job 
location 

lock requests, 6.2 


lndex-1 






Index 


logging on to Sll command 
interpreter, 66.1 
logical device names, 3.1 
logical system, 1 
logical systems, 2.1 
LOGON, 66.1 

M 

maint, 74.1 
MEM, 66.9 
MEMO, 25.1 

message broadcaster—see 
EMSG, CMSG 
message file, 48.1 
message groups, 8.7 
mirrored volumes, 1.6 
MSG, 7.1 
MTCU, 1.9 

N 

NAME, 66.9 

named process, list of, C.1 
net node name, 3.1 
NonStop, 1.1 
NonStop processes, 2.4 
NOWAIT, 66.9 
NULL.NULL, 97.4 
number, job—see job 
number 

NUMCOL, 86.14 

0 

obey, 66.6 

obey file, 66.6,66.12, 87.13 
obey files, 2.2, 42.1, 99.1 
obey take, 62.1 
obey takes, 90.3 
ONLY, 86.7 
oops copies, 76.1 
operating system, 2.2 
OSP, 1.3 
OUT, 66.9 

OUTMON, 27.1,28.1 
output monitor process—see 
OUTMON 

OUTTAKE. 27.1,28.1 
OWNER, 86.10 
o—see obey 

p 

page faults, 101.10 
PAGES, 86.10 
passwords, 97.4 
PATH, 89.3 
PAUSE. 66.6 
PCIA, 1.10 

PERCENT, 50.1,76.1 
physical system, 1,2.1 
PID—see process identity 
number 
PIPE. 77.1 
POCTAL, 86.15 
power supplies, 1.4 
PPD, 66.6 
PRI, 66.9 

primary process, 2.4 
PRINT, 78.1 
PRINTH, 79.1 
PRIORITY, 86.9, 86.13 
process distribution, 101.2 
process identity number, 2.3 
process names, 2.3, 3.3, 4.1 


process priorities, 101.3 
process revision levels, 73.1, 

80.1 

process statistics, 81.1 
process transactions, 
accumu'ating—see 
GSTAT 

process types, D.1 
processes, named, list of, 

C.1 

PROG, 66.11 
program files, 2.3, 42.1 
program scheduler—see 
SCHED 

program scheduling, 87.1, 
87.7, 87.9 
PROGREV, 80.1 
PROOF, 29.1 
proof format options, 29.4 
proof key record, 60.1 
PROOF process 
parameters, 29.3 
proof process parameters, 

29.4 

proofs, VDT attributes in, 

29.5 

PSTAT, 81.1 
PUP, 2.3, 8.2 
PUPLISTDEV, 101.2, 

101.9, 104.1 

PURGE, 14.1,30.1,64.1, 
66.7 

Q 

Q process, 52.1 
Q-extracts, 61.1 
q-field file, 52.1 
Q-fields, 52.1 
QREQUEST, 82.1 
QUME, 31.1 

R 

RALPH, 1.10 
RCVR, 8.2, 32.1 
READYQ, 83.1 
REAUDIT, 84.1 
receiver process—see 
RCVR 

record interlocks, 6.1 
record types, E.1 
RECVQLEN, 101.2 
REJECT, 89.4 
RELOAD, 66.8 
RENAME, 66.8 
REPORT. 86.10 
report name, 86.7 
report names, 86.2 
REQUEST. 8.3,85.1 
requestor process. 2.4 
requestor processes, 5.1, 

6.1 

RESTORE, 89.3 
REWIND. 89.5 
RGEN, 62.1,90.2 
RGEN extract file. 62.1 
ROUTER. 33.1 
routing record filter—see 
ROUTER 
RSCAN, 89.6 
run, 66.8 
rund, 66.8 


s 

SAVE, 14.1,34.1,89.6 
save string file, 49.1 
save, background—see 
SAVE 

SCAN, 86.2, 89.6 
SCAN commands, 86.5 
SCHED, 35.1 
SCHEDSET, 35.1,87.1, 

97.4 

search string, 86.12 
securing files, 97.5, 97.8, 
97.11 

security, 97.1 
security, VDT, 98.1 
SELECT, 86.7. 86.8, 89.4 
selecting jobs, 86.7 
SEND, 94.4 
server process, 2.4 
server processes, 5.1,6.1 
server requests, no wait, 6.2 
server requests, wait for, 6.2 
SET, 89.4 
SHOW, 89.4 
shutdown, 100.1 
SIGNON, 94.6 
Sll command interpreter, 
66.1 

Sll command interpreter, 
exiting, 66.2 

Sll command interpreter, 
logging on to, 66.1 
SPELL, 36.1 
spell check, 36.1 
SPLS, 2.3, 86.1 
SPOOLCOM, 86.2. 86.3, 
99.9 

SPOOLDEV, 86.3 
spooler, 86.1 
spooler PARMs, 86.3 
spooler print process—see 
JOBS 

spooling system. 86.1, 86.2, 
99.9,99.10, 99.11. 
99.14,99.15 

spooling system collector, 

86.1 

Standard Patch Panel, 1.10 
START, 94.6 
STARTCOL. 86.14 
STATE. 86.9 
STATUS, 66.9 
STOP, 66.11.94.5 
story duplicator—see 
BURSTER 
super id. 97.2 
SUPER.SCHED. 97.2 
SUPER.SUPER. 97.2. 97.5. 
97.13 

SUPER—see ZEUS 
suspend. 66.12 
swap activity, 101.1 
SWAP RATE. 101.2, 101.13 
SYSTEM. 66.13 
system balancing. 101.1 
system coldstart, 100.1 
system command files. 42.1 
system components, 1.1 
system overseers—see 
EGOD.CGOD 
system shutdown, 100.1 


T 

Tandem u ;er ID, 97.1 
TAPE, 89.1, 104.2 
TAPE commands. 89.3 
tape drive. 1.5, 1.8 
TAPESET. 89.3 
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Reader Comment Form 

Did you find errors in this manual? If so, specify by page. 


Did you find this manual useful, easy to understand, and well organized? Please make 
suggestions for improvement. 


Is there sufficient documentation for use of the software described in this manua|? If not, 
what material is missing? 
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If you would like a written reply, please check here □ 











































































